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HP-UX Quick Reference 


How to use this card: 

1. To refer to selected HP-UX commands, place this card near your display. 

2. Type the commands as they are shown in the second column below. 

3. Include paths with file names, if you are working with different directories. 

4. Follow each command with 1 Return 1 . 


To Do This ... 

Type This ... 

Working with Directories: 


Show current working directory 

pwd 

Change directory 

cd directory_path 

Change to home directory 

cd 

Create a directory 

mkdir directory_name 

Remove an (empty) directory 

rmdir directory_name 

Display permissions for a directory 

11 -d directory_name 

Change permissions for file or directory 

chmod permission_nos name 

Symbolically change file or directory permissions 

chmod class—permissions name 

Working with Files: 

- —■“ 

Read mail 

elm 

List files and directories in current directory 

Is 

List all files or directories, including invisible 

Is -a 

(“dot”) files 


List files, and show directories with “/” 

lsf 

Display permissions for a file 

11 file_name 

Create or edit a file 

vi file_name 

Display file contents 

more file_name (fq~| to quit) 

Copy a file 

cp jile_name jile_copy 

Move a file to a new file name 

mv old_file newjile 

Append filel onto the end of file2 

cat filel » ]ile2 

Remove file 

rm file 

Display the first 10 lines of a file 

head file_name 

Check the spelling in a file 

spell file_name 

Print a file 

lp file_name 
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To Do This ... 

Type This ... 

Finding and Organizing: 


Find file(s) beginning with x in current- and sub- 

find . -name * X *’ -print 

directories 


Find all occurrences of word in all files in current 

grep word * 

directory 


Sort listfile of two-word names by last name 

sort +1 listfile 

Display date and time 

date 

List all aliases 

alias 

Find HP-UX command information 

man command_name 

Determine PATH setting 

echo $PATH 

System Operations: 


Clear screen 

clear 

Set command-line editor 

set -o editor_name 

Edit your command line (in Korn/Key Shell set 

| ESC | (use vi commands) 

for vi) 


Recall previous command line (with vi editor) 

| ESC | k (back) or j (forward) 

Execute previous command line 

I Return | (when line is displayed.) 

Set terminal type (select term_type from 

TERM =term_ type 

/usr/lib/terminfo) 


List current process status and PID \s 

ps -ef 

Kill (terminate) a process 

kill PID 

Create or change a password 

passwd 

Redirect input from a file to a command 

command < infile 

Connect two processes with a “pipe” 

commandl 1 command2 

Network Operations: 


Invoke ftp and connect to remote_host 

ftp remotejiost 

Copy files from remotejiost with ftp 

get remote_file (while in ftp) 

Copy files from local current directory to current 

put locaLfile (while in ftp) 

directory on remote_host 


Exit ftp 

bye 

Copy a file from your locaLfile to a file on a remote 

rep locaLfile 

host, using rep 

remote _hostname: remote_file 

Copy a file from a remote host to your local 

rep remote_hostname: 

directory, using rep 

remote_file locaLfile 

Log in on a remote system 

rlogin remote-hostname 
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vi Editor Quick Reference 

How to use this card: 

1. To refer to selected vi commands, place this card near your display. 

2. Type the commands as they are shown in the second column below. 

3. Follow colon (:) and search (/) commands with | Return I , as indicated. 


To Do This ... 

Type This 
in Command Mode 

Getting Started with vi: 


Read, create, or edit a file ( enter from shell ) 

$: vi filename 

Make sure you’re in command mode 

1 ESC 1 

Show whether you are in command or insert mode 

: set showmode | Return | 

Find out what file you are in 

fCTRLT-m 

Moving Within the File: 

Move the cursor left or right 

Use h or 1 key. 

Move the cursor up or down 

Use k or j key. 

Cursor to end of line 

$ 

Cursor to beginning of line 

0 (zero) 

Cursor to end of file 

G 

Cursor to beginning of file 

1G (one G) 

Editing Text: Inserting: 

Insert text at the cursor position 

i 

Insert (append) text after the cursor position 

a 

Backspace to overwrite previous character (in 

| CTRL H h | or | Back space | 

Insert Mode ) 

Editing Text: Deleting: 


Delete characters at cursor 

X 

Delete word (cursor at beginning) 

dw 

Delete entire line at cursor position 

dd 

Delete from cursor to end of current line 

D 

Delete from cursor to end of file 

dG 

Moving Text: 


Join lines of text 

J 

Copy a line into a buffer 

yy 

Put copied or deleted text line after cursor line 

p 

Read in another file after cursor line 

: r filename | Return | 
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To Do This ... 

Type This 
in Command Mode 

Searching and Marking Text: 

Search for words 

Repeat the previous search for words 

Place invisible mark at current cursor position 
Move cursor to invisible marker 

/words | Return | 
n (forward) or N (backward) 
m( a-z) 

: ( a- ’ z ) | Return | 

Saving and Printing Files: 

Save file in same file name 

Save file to a new file name 

Exit from file without saving changes you’ve made 
Overwrite another existing file with this file 

Save and exit from file 

Print a file from within that same file 

Print another file from within a file 

: w | Return | 

: w new_file_name | Return | 

:q! 

: w ! other_ file_name | Return | 

: wq | Return | 

: ! Ip % | Return | 

: ! Ip file name [ Return | 

Repairing Mistakes: 

“Undo” the previous action 

Restore a line to its previous state 

Restore (“put”) last delete 

Restore current file, disregarding changes since 
saving 

Compare changes “before and after” an action 
Recover a file after a system interruption (from 
shell) 

u 

U 

P 

: e! | Return | 

u ( repeat to “toggle”) 

$: vi -r filename 

In General: 

Execute shell command cmd from within file 

Set line length (wrapmargin) n lines from right 
Display current options 

Display all options 

Abbreviate string with str 

Display all abbreviations 

Unabbreviate str 

: ! cmd | Return | 

: set vm=n | Return | 

: set | Return | 

: set all | Return | 

: ab str string | Return | 

: ab | Return | 

: una str | Return | 


For more information, see The Ultimate Guide to the vi and ex Text Editors. 
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Getting Started 


HP-UX is a powerful and versatile system that meets the computing needs 
of diverse groups of users. You can use HP-UX simply to run applications, 
or you can develop your own applications in its rich software-development 
environment. In addition, HP-UX offers powerful subsystems, such as 
electronic mail, windows, networking, and graphics. 

This book introduces you to HP-UX so that you can become productive as 
soon as possible. 


Finding Information in this Manual 

The following aids will help you in using your HP-UX system: 

■ Two indexes: 

□ Task Index, giving references to specific task information. 

□ Main Index, giving references to commands and general references. 

■ In the front of this manual, you will find: 

□ The HP-UX Quick Reference 

□ The vi Editor Quick Reference 

These are tear-out cards which you can place near your system to help you 
recall the most useful commands while you are learning HP-UX and vi. 
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Before You Begin ... 

This guide was designed to get you “up and running” on HP-UX as quickly as 
possible. For example, after reading this chapter and Chapter 2, you should 
immediately be able to start using the system and running some commands. 

This chapter leads you through your first work session on HP-UX. You should 
read and do the specific tasks in this chapter in one sitting and in the order in 
which they appear. 

Before you start this chapter, get your username and password from the system 
administrator or the support person who installed your system. You will need 
this information in the first section, “Logging In.” 
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Chapter Contents 

This chapter discusses the following topics: 

■ How to use this guide. 

■ Getting to know your system. 

■ Logging in—identifying yourself to HP-UX so you can start a work session. 

■ Using the command line. 

■ Setting your password—to help ensure the security of your system. 

■ Logging out—exiting from HP-UX when you’re finished using the system. 
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Conventions 

This book uses the following typographical conventions within examples: 


If you see ... 

It means ... 

colored text 

You type the text exactly as shown. For example, 

more sample_filef Return) 

means you should type exactly those characters. 

computer text 

Text displayed by the computer system. For example, 

login: 

indicates a login prompt displayed by the system. 

italic text 

You supply the text. For example, 

more file-name 

means that you type more followed by a file name of your choice. 

Italic text also is used as annotation. 

0 

You type the corresponding key on the keyboard. For example, 

(ctrl)-(d) 

means you hold down the [ctrl] key, and press the (d) key. 
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For More Information ... 


For details on all the manuals you can get with HP-UX, see Finding HP-UX 
Information. 


Notes: 
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Getting to Know Your System 

Throughout this guide, you will see the term system administrator. The 
system administrator is someone who manages your system, taking care of 
such tasks as adding peripheral devices, adding new users, and doing system 
backups. In general, this person (who may also be called the system operator 
or something similar) is the one to go to with questions about implementing 
your software. 

However, if you are the only user on a single-user system, then whenever this 
guide refers you to the system administrator, you should be able to get help 
from the system administration manuals that you have purchased with your 
system. If you need other kinds of information, it will help to identify someone 
in your organization who is experienced in HP-UX and who can provide help 
with user problems. If such a person isn’t available, your HP support engineer 
can also provide installation and maintenance help, in accordance with your 
support contract. 

Visual Help for the User 

Most of this guide assumes you will be using the Bourne, Korn, or Key 
command interpreters (or shells as they are called in HP-UX terminology). If 
you need to find about using the C Shell, see the Appendix. With these shells, 
you run a command by typing the command’s name on a command line and 
pressing the (Return 1 key. 

For example, you can run the date command by typing: 

$ date (Return) 

Mon Nov 12 09:54:23 MST 1990 

Typically, in order to get started with HP-UX, you’ll need to refer to the first 
chapters of this manual for command names and syntax, or you can use the 
HP-UX Quick Reference, which you’ll find in the front of the manual, along 
with the vi Editor Quick Reference . You can tear these out and place them 
near your display. 

But, if you’d like to get visual help directly from the screen while you are 
working with commands, the following sections describe some alternatives 
which HP-UX provides for you. 
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PAM—The Personal Application Manager 

As an alternative to command-line oriented shells, you can opt to use PAM, 
the Personal Applications Manager. PAM implements a visual, menu-oriented 
interface that uses arrow keys and the softkeys ((7T) ... (re)). 

To learn more about PAM, refer to the Shells: User’s Guide and the pam entry 
in section 1 of the HP-UX Reference. 

The Key Shell: Visual Help for the Korn Shell 

The Key Shell gives you help on most HP-UX commands by displaying softkey 
command-names and options in sequence. You can select from these and let 
the Key Shell build your command lines “in English” before you have mastered 
the commands and command syntax of HP-UX. In general, the discussion 
of the Korn Shell in this manual also applies to the Key Shell. For specific 
information on using the Key Shell, see Chapter 4, in this manual, and the 
Shells: User’s Guide , 

TSM: Window-Like Functions for Terminal Users 

TSM (“Terminal Session Manager”) allows you to run multiple HP-UX 
programs, each in its own session, on your terminal. TSM provides an easy 
method for switching quickly between these sessions making your terminal 
appear to be ten “terminals.” Each of these “terminals”, called a TSM session, 
can run its own independent program. Thus, TSM provides some of the 
functionality of a windowing system like VUE or X-Windows. 

When TSM starts, it will automatically start a list of programs that you 
specify. 

TSM has two operating modes: menu mode and command mode. In menu 
mode, you can quickly select the desired task from a pull-down menu. 

Command mode allows you to “flip” back and forth between the programs in 
each session as if you were moving your eyes and fingers from one terminal to 
another. 

For more information on TSM, see the Terminal Session Manager: User’s 
Guide and the tsm entry in section 1 of the HP-UX Reference. 
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VUE: the Visual User Environment 


VUE is a graphical user interface based on the X Window System and 

OSF/Motif standards. It has several components which will help you use your 

system faster and more intuitively: 

■ Login Manager. This gives you a window to enter your name and password 
at login, and makes it easier to correct mistakes in doing so. You can also 
specify which language you want HP VUE to use in the Login Manager. 

■ File Manager. By manipulating icons, this interface allows you to navigate 
through directories on your local system and on remote workstations. 

■ Workspace Manager. This lets you manage and navigate through multiple 
workspaces (logical collections of windows and icons). You can create and 
use multiple workspaces for different tasks. 

■ The Style Manager. You can customize your working environment and 
startup configuration through the use of this system aid. 

■ Help Manager. This gives you easy access to man pages containing 
information on HP-UX commands, and to other system information. 

For More Information on VUE 

The following manuals will give you further guidance in using VUE: 

■ HP Visual User Environment User’s Guide. 

m HP Visual User Environment System Administration Manual. 
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Your Shell Command Interpreter 

Whenever you enter a command, you are making use of a command interpreter 
which interprets that command for HP-UX. The command interpreter is called 

a shell. 

When you log in, you are said to be “in” a shell. HP-UX supports several 
different shells which behave in slightly different ways and give you varying 
amounts of interactive support at your display. These are called the Bourne, 
Korn, Key, C, and PAM Shells. Your system administrator determines which 
shell you get when you first log in, and you have the option of changing shells 
later. 

If, after logging in, you see a Personal Applications Manager menu screen, your 
shell is the PAM Shell. Otherwise, you can determine which shell you’re “in” 
by typing the following command: 

$ echo $SHELL 


If echo $SHELL displays ... 

Then your shell is ... 

/bin/sh 

Bourne Shell 

/bin/csh 

C Shell 

/bin/ksh 

Korn Shell 

/usr/bin/keysh 

Key Shell 


You’ll find more details about this, as well as information about the features of 
each of these shells in Chapter 9 and Chapter 10 in this manual. 

For More Information on Shells 

Your shell has many productivity-enhancing capabilities you may find useful 
after you’ve mastered the basics in this book. To learn about shells in detail, 
also refer to Shells: User’s Guide. 
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Logging In 

To begin using HP-UX, you must log in. When you log in, HP-UX 
prompts you for your username and password (if you have one). On some 
systems, you may also have to respond to a “TERM = (hp)” prompt. When 
you have finished logging in, you should see a command line prompt which 
means that you can proceed with entering commands on the system. 

If you are using VUE (Visual User Environment) or the X Window 
System, you have an automatic login window which will provide a form for 
your entries, once your login and password are set. 


1. After you boot your system, you should see this prompt: 

login: 

If you don’t see this prompt, consult your system administrator or HP-UX 
System Administration Tasks. If you are working with a system equipped 
with NLIO, see your NLIO System Administration manual. 

2. When you see the login prompt, type your username and press ( Return ) . Your 
username identifies you as a valid user of the system. HP-UX lets you log in 
only if you have a username. For example, if your username were leslie, 
you would type: 

login: leslie( Return ) 

3. Unless you are using VUE, the ( Back space) key does not work during login. If 
you make a mistake when typing, press ( Return ) once or twice and HP-UX will 
display a new login prompt, so you can re-enter your username. 

4. If you have a password, you should see a password prompt after entering 
your username: 

Password: 
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5. Your password is an “invisible” codeword known only to you. Passwords 
help ensure your system’s security. When you see the password prompt, 
type your password and press (Return ) . To ensure that other users cannot see 
your password, HP-UX does not display the characters as you type them. If 
you do not have a password, see your system administrator or skip to step 

6. To see how to create a new password on your system, see the section, 
“Setting Your Password”, in this chapter. 

6. If you are using VUE, you will be using a special log-in window rather than 
using the command-line procedure. In the password section of the window, 
your “invisible” password will be indicated by a series of asterisks as you 
type the characters. You may backspace over these characters if you need to 
retype some or all of your password. 

7. Every terminal or graphics display has a terminal type (or term-type), which 
HP-UX must know to communicate with the terminal. If HP-UX doesn’t set 
the term-type automatically, you will be prompted for it: TERM = (hp) 

If you see this prompt, ask your system administrator for your term-type, 
and enter it. (You’ll also find a listing of possible settings in Table 9-7 in 
Chapter 9). For example, if you use a “2392a” terminal, type: 

TERM — (hp) 2392a ( Return ) 

If you don’t know your term-type, enter nothing and press (Return ) . The 
system will automatically set up your display according to default values 
appropriate to most HP terminals. 


Note If your display should behave strangely, especially when you 

are working in vi, the cause will likely be in your term-type 
setting. If this happens, check, and, if necessary reset your 
TERM variable. 
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8. If you have completed the preceding steps correctly, HP-UX typically 
displays a welcome and copyright message, followed by a command prompt. 
A command prompt indicates the system is ready to accept commands. 
Typical prompts are $ or '/,. 

9. If you are using PAM (Personal Applications Manager), you’ll see the PAM 
menu instead of a command prompt. If you see a prompt, you can proceed 
to the next section “Typing Commands.” 
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If Problems Occur 


Listed below are some messages you might see during login and what to do if 
you see them. (If you see other messages, consult your system administrator.) 


If you see the message ... 

Do this ... 

Invalid login, 
login: 

Check to see if you have 
made a mistake when typing 
either your username or 
password. Then try again. 

Your password has expired. Choose a new one. 
Changing password for leslie 

New password: 

Enter a new password. See 
the section “Setting Your 
Password”, in this chapter. 

Maximum number of users already logged in. 

You must wait until someone 
logs out before you can log 
in. Try again later. 
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Using the Command Line 

To run a command, type the command’s name after the command line 
prompt, and press [ Return ) . To correct typing mistakes, use the [ Back space 1 key. 


The Command Line Prompt 

When you see the command line prompt, you can begin typing commands. 

By default, the command line prompt is either $ or °/ 0 , but it can be different, 
depending on how your system administrator has set up your account. In 
any case, you can locate the prompt by pressing (Return) several times; HP-UX 
displays the prompt every time you press (Return) : 

$ (Return) For the purposes of clarity and consistency, 

$ (Return) examples throughout this book use the $ prompt. 

$ 

Running Commands 

To run a command, type the command’s name after the prompt and press 
(Return) . The command then will begin running. When the command finishes, 
the prompt reappears. For example, run the following whoami command now: 

$ whoami (Return ) 

leslie Your user name appears here. 

$ Then the command line prompt reappears. 

If you make a mistake when typing a command, use the (Back space) key to back 
up and correct it. 

(To make examples as clear as possible, the remainder of this book will not 
show the (Return) key at the end of each command line.) 
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To get the feel of using commands, run the date and cal commands: 

$ date Displays the current date and time. 

Mon Sep 24 16:56:07 MDT 1990 


$ cal 

Displays an English calendar for the current 
month. 

September 1990 

S M Tu W Th F S 

1 

2 3 4 5 6 7 8 

9 10 11 12 13 14 15 

16 17 18 19 20 21 22 

23 24 25 26 27 28 29 

30 



You’ll get more practice at using the basic commands of HP-UX as you go 
through the following chapters in this manual. 
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Setting Your Password 

Passwords help prevent unauthorized users from logging in to the system. 

If you don’t have a password, set one that only you know. When you’ve set 
a password, change it occasionally to ensure system security. Use the 
passwd command to set or change your password. (To learn more about 
system security and selecting a secure password, refer to Chapter 12 
“Making Your System Secure.”) 


Choosing a New Password 

Choose your new password according to these rules: 

■ The password must contain between six and eight characters. 

■ At least two characters must be letters (uppercase or lowercase). 

■ At least one character must be either of the following: 

□ Numeric (the digits 0 through 9). 

□ Special (neither letters nor numeric—for example, -, _, or $). 

According to these rules, the following are all valid passwords: 

foo-bar $money$ Number_9 Orophy 

Also, uppercase and lowercase letters are different. Thus, these are all different 
passwords: 

foo-bar Foo-Bar FOO-BAR 

When you choose a password, you want to ensure that no one can guess what 
you chose. If someone knows your password, that person may log in and access 
your files. Chapter 12 “Making Your System Secure” offers suggestions on 
how to select and protect your password. These guidelines are of particular 
significance if you work with sensitive material. 

Running the passwd Command 

When you’ve chosen your new password, set it by running passwd: 

$ passwd 

After you’ve entered the passwd command, it leads you through these steps: 
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1. If you don’t have a password, skip this step. If you do have a password, 
passwd prompts you to enter it. 

Changing password for leslie Your username appears here. 
Old password: Enter your current password. 

2. When you see the following prompt, enter your new password. 

New password: 

3. Next, you need to re-enter the new password to verify it: 

Re-enter your new password: 

Now, when you log in again, use your new password. 

If Problems Occur... 


If you see this ... 

You might have done this ... 

Sorry. 

Typed your current password incorrectly 
to the “Old password:” prompt. Run 
passwd again. 

Password is too short - must be 
at least 6 characters. 

Specified a new password with less than 
six characters. 

Password must contain at least two 
alphabetic characters and at least 
one numeric or special character. 

Specified a new password that doesn’t 
conform to the rules described earlier. 

They don’t match; try again. 

Typed your new password differently 
when prompted to re-enter it. 

Too many failures - try later. 

Made too many mistakes. Try again. 
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Logging Out 


When you’re finished with your HP-UX work session, log out using the 
exit command. On some systems, you can use [ctrl Y (d) to log out. If 
you’re using PAM, use (ctrl K cT). Logging out ensures that no other person 
can use your account when you leave. (For additional information on 
making your account secure, refer to the chapter “Keeping Your System 
Secure” in this manual.) 


Using exit 

Perhaps the most common way to log out is by using the exit command: 
$ exit 


Using CTRL-D 

Another commonly accepted way to log out is to hold down (ctrl) while 
pressing © ( ( ctrl Hp ). On some systems, however, this may not work, and 
you’ll see this message: 

Use "exit" to logout. 

Using CTRL-C (with PAM) 

If you’re using PAM (the Personal Applications Manager), you can exit by 
holding down f ctrl ) while pressing (c) ( (ctrl H D). 
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The “logout” Message 

When you log out, HP-UX typically displays a logout message, followed by a 
new login prompt. Your screen might look something like this after you log 
out: 

$ exit 
logout 

login: 


At this point, you or any other user can log in. 

If none of the methods described above logs you out, consult your system 
administrator or the manual HP-UX System Administration Tasks. 


Getting Started 


1-19 






Chapter Command Summary 


Table 1-1. Commands 


To Do This ... 

Type This ... 

Log in 

(after login:) your-username 
(after Password:) your-password 
(after TERM =) your-terrri-type 

Enter a command 

(type the command after the 
prompt and press (Return 1) 

Find out your shell name 

echo $SHELL 

Set or change password 

passwd 

Log out 

exit 
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Working with Files 


Conceptually, a file is a named container in which you can store information. 
Files are the basic means which HP-UX uses to organize information. In using 
HP-UX commands and applications, you create files containing a variety of 
data. This chapter discusses various aspects of handling files: 

■ Creating and listing files. 

■ Naming files. 

■ Viewing and printing files. 

■ Renaming, copying, and removing files. 

■ Finding out who can use your files. 
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Creating and Listing Files 

Using the cat command, you can create a file containing text. To list the 
names of your files, use the Is command. 


Creating a File with cat 

The examples in this chapter and in remaining chapters assume you’ve created 
a text file named myf ile. To create the file, use the cat command as follows: 

$ cat > myfile 


After you type this command, the cursor sits on a line by itself: you can now 
type text into the empty file. (Press f Return 1 at the end of each line you type.) 
When you have finished entering text, press (Return). Then hold down [ Ctrl j 
and press ©• The cat command stops and returns you to the command line 
prompt. 

You can use the cat command to create your own version of myfile. For 
example, you might create the file as follows: 

$ cat > myfile 

The text I am typing will be stored in "myf ile. " [ Return) 

I press RETURN at the end of each line . [Return) 

When I’m finished, I hold down the CTRL key and press D. [ Return) 
(CTRL ) -fp~| 

$ 


Note You can also create and edit files using a text editor such as vi. 

To learn how to use this editor, see Chapter 6 in this manual, 
“Writing and Editing with the vi Screen Editor.” 


2-2 Working with Files 






















Listing Files Using Is 

To verify that cat created myfile, run the Is command, which lists the names 
of your files. Running the Is command with the file name will confirm that 
that file exists, but won’t list other files. 

$ Is myfile The Is command lists myfile. 

myfile 

(Viewing the file’s contents is discussed in the section, “Viewing and Printing 
Files.”) 
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Naming Files 

When you choose a file name, you need to follow certain rules regarding 
the length of the name and the types of characters you include. If a file 
name begins with a dot (.), it is “invisible” and the Is command normally 
will not list it. To see invisible file names, run Is with the -a option. 


Choosing a File Name 

When you choose a file name, remember these rules: 

■ Generally, file names can contain up to-14 characters (or bytes, in non-ASCII 
character sets), which can be any combination of the following: 

□ Uppercase or lowercase letters (A through Z; a through z) 

□ Digits (0 through 9) 

□ Special characters, such as: . 

Based on these rules, the following are valid file names: 

money Acct.01.87 CODE.c 

lost+found 112.3-data toolbar 

■ HP-UX interprets uppercase and lowercase letters differently in file names. 
Thus, the following file names all are different: 

money Money MoneY MONEY 


Note Some systems may be configured to accept file names longer 

than 14 characters. However, before you create files with longer 
names check with your system administrator. If your system is 
not configured correctly, the longer file names will be truncated 
to 14 characters, and may cause difficulties. 
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Invisible File Names 


A file name in which the first character is a dot (.) is an invisible file name, 
since the Is command does not normally display it. Use invisible file names if 
you don’t want or need certain files displayed when you run Is. 

To illustrate, you have an invisible start-up file that the system runs when you 
log in. In HP-UX terminology, this file is called a login script. It is used to 
customize your working environment. To learn more about login scripts, see 
the chapter, “Customizing Login Scripts,” in this manual. 

Note that the behavior of your system, including the name of your login script, 
is determined by the type of command interpreter, or shell, that your system is 
using. Common shells used with HP-UX include the Bourne, Korn, C, and Key 
Shells. The Key Shell is an interactive shell which uses all the same functions 
as the Korn Shell. 

To force Is to list invisible file names, including the name of your login script, 
run it with the -a option: 

$ Is -a Use -a to see invisible file names. 

.profile myfile This is the Bourne Shell, so .profile is 

shown. 


If your shell is ... 

Then your start-up file is ... 

Bourne Shell 

.profile 

C Shell 

.login 

Korn Shell 

.profile 

Key Shell 

.profile 

PAM Shell 

.environ 
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Viewing and Printing Files 


Using the more command, you can look at the contents of a text file. If 
your system is appropriately configured, you can print a text file using the 
lp command. 


Viewing a File with more 

The more command displays a text file’s contents on the screen. For example, 
the following more command displays the contents of myf ile (which you 
created in the section, “Creating and Listing Files”): 

$ more myfile 

The text I am typing will be stored in "myfile." 

I press RETURN at the end of each line. 

When I’m finished, I hold down the CTRL key and press D. 

$ 

If the file contains more lines than are on your screen, more pauses when the 
screen is full. With a longer file, press ( space 1 to continue looking at additional 
screens, and press (o) when you are finished. Then more returns you to the 
system prompt. 

Try running more on the system file /etc/disktab: 

- .. 

$ more /etc/disktab 

# Q(#) $Revision 64.5$ 

# 

# This file Contains the disktab entries for the current 

# sectioning scheme. 

# 

# Note that the section sizes are in terms of DEV_BSIZE which 

# is defined to be 1024 bytes. 

# 


-More-(4%) 
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The “—More--(4°/ 0 )” message at the bottom of the screen means you’ve viewed 
4% of the file thus far, and 96% of the file remains to be viewed. At this point, 
you can do any of the following: 

■ Scroll through the file a page at a time by pressing the space bar. 

■ Scroll through the file a line at a time by pressing ( Return) . 

■ Quit viewing the file and leave man by pressing Q. 

Printing a File with Ip 

If your system is appropriately configured, you can print a text file using the lp 
(line printer) command. Before using the lp command you may need to find 
out whether your system is set up so that you can use the lp command. If it 
is not, you may have to use a command other than lp to get printouts. You 
can find information on managing printers and other peripherals in System 
Administration Tasks. 

If lp does work on your system, you may also need to find out the location of 
the printer, on an extensive system. When you have this information, print 
myf ile by running the lp command: 

$ lp myfile 

If the lp command is working properly, it should display a message indicating 
that it sent your file to the printer. For example: 

request id is lp -number (1 file) 

The number is an i.d. number assigned to the print job by the lp command. If 
you don’t see this message, or if you get an error message, consult your system 
administrator. If lp works successfully, you should get a printout with your 
username displayed on the first page. The time required for a printout depends 
on the number of tasks being run by the system and the speed of the printer. 

To display a report on the printer status, including the order of your print job 
in the printer que, type: 

$ lpstat -t 

To cancel a print job, enter the cancel command, with the i.d. number for 
your job: 

$ cancel request-id 
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Renaming, Copying, and Removing Files 

To change a file’s name, use the mv (“move”) command; to make a copy of 
a file, use the cp (“copy”) command; to remove a file, use the rm 
(“remove”) command. The examples in this section assume you have 
created the file myf ile, as described in “Creating and Listing Files.” 


Renaming Files with mv 

Using the mv command, you can rename the file myfile to foofile as follows: 

$ mv myfile foofile 

To verify that mv renamed the file, use the Is command: 

$ Is 
foofile 

To rename foofile back to myfile, type: 

$ mv foofile myfile 

$ Is Using Is, verify that it worked. 

myfile It worked! 

Caution When renaming files, take care not to rename a file to the name 
of a file which already exists in that directory. If you do this, 
the file that already has the name will be lost. 


For example: 


$ Is 

afile bfile 
$ mv afile bfile 
$ Is 
bfile 


If you had these files ... 

And you rename afile to bfile ... 

Look what happens ... 

The previous bfile is replaced with the old afile. 


(The mv command can also be used to move files to different locations on the 
system. This concept is discussed further in Chapter 3 in this manual, “Using 
Directories to Organize Your Files.”) 
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Copying Files with cp 

Copy a file when you want to make a new version of it while still keeping 
the old version around. For example, to make a new copy of myf ile named 
myfile2, type: 

$ cp myfile myfile2 

Now when you use the Is command, you will see the following: 

$ Is 

myfile myfile2 

Use more to view myfile2. You will find that it is the same as myfile. 
Caution If you copy a file to an existing file, the existing file will be lost. 


Removing (Deleting) Files with rm 

If you have files that are no longer needed, you should remove (delete) them. 
Deleting unnecessary files leaves more room for other files on your system. For 
example, suppose you’ve finished using myfile2, and it is no longer needed. To 
remove myfile2, type: 

$ rm myfile2 

To see that myf ile2 was removed, use Is: 

$ Is The directory listing shows only the other file now remains. 
myfile 

Permission to Access Files 

Files are assigned access permissions that control who has permission to read 
or alter files. If you don’t have the necessary access permissions to a file, you 
may not be able to rename or copy it. If this is the case, the system will 
display a message indicating that you can’t perform the command. You can 
find out more on access permissions in the next section and in Chapter 12 in 
this manual, “Making Your System Secure.” 
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Finding Out Who Can Use Your Files 


Three classes of users (in various combinations) can access files: owner, 
group, and other. Each class may access files in various ways: read 
permission, write permission, and execute permission. Use the 11 
command to view file access permissions. 


Access to files is restricted by classes of users. The three basic classes of users 

are: 

■ owner —Usually the person who created the file (for example, you). 

■ group —Several users who have been grouped together (along with you as the 
owner of the file) by the system administrator (for example, the members of 
your department). 

■ other —Any other user on the system. 

Each of the above classes can access files in any of these three ways: 

■ read permission —Users with this type of permission can view the contents of 
a file. 

■ write permission —Users with this type of permission can change the contents 
of a file. 

■ execute permission —Users with this type of permission can execute (run) the 
file as a program by typing the file name at the command line prompt. 

Using the II Command to Display File Permissions 

The 11 ( long /isting) command displays the permissions for owner, group, and 

other', 11 also displays the name of the file’s owner and group. 

Here is a closer view with all permissions indicated (note that the permissions 

are in sets of three): 

rwx rwx rwx 

I I I 

owner group other 
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To see the permissions, owner name, and group name on myf ile, for example, 
type the following: 

$ 11 myfile 

When you press [ Return ) , you should see something like this: 

-rw-r—r— 1 leslie users 154 Nov 4 10:18 myfile 

permissions owner group size date file name 

The first dash on the left indicates that myfile is a file (if myfile were a 
directory, you would see a d in place of the dash). The next nine positions 
indicate read, write, and execute permissions for owner, group, and other. 
When filled, with all permissions granted for a directory, the permissions look 
like: 

drwxrwxrwx 

If a permission is not allowed, a dash appears in place of the letter. 

In the example (-rw-r--r--), owner (leslie) has read and write permission 
(rw-); group (users) and other have only read permission (r—). 

For More Information ... 

To learn more about the 11 command, refer to the HP-UX Reference (the 11 
command is listed under Is in section 1 of the Reference). 

For information on how to change the access permissions on files and 
directories, see Chapter 12 of this manual, “Making Your System Secure.” 
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Chapter Command Summary 


Table 2-1. Commands 


To Do This ... 

Type This ... 

Create a file 

cat > filename 

Terminate keyboard input for cat 

[CTRL KF) 

List visible files in current directory 

Is 

List visible and invisible files in current 

Is -a 

directory 


View a file 

more filename 

Print a file 

lp myfile 

Rename (“move”) a file 

mv fromfile to file 

Copy a file 

cp fromfile tofile 

Delete (remove) a file 

rm filename 

Find out access permissions 

11 filename 
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Organizing Files in Directories 


After you’ve used your system for a while, you may start accumulating a large 
collection of files. With the help of directories, you can organize your files into 
manageable, logically related groups. For example, if you have several files for 
several different projects, you can create a directory for each project and store 
all the files for each project in the appropriate directory. 

This chapter discusses the following topics: 

■ What is a directory hierarchy? 

■ Determining your location in the HP-UX directory structure. 

■ Specifying files and directories: absolute path names. 

■ Specifying files and directories: relative path names. 

■ Creating directories. 

■ Changing your current directory. 

■ Moving and copying files between directories. 

■ Removing empty directories with the rmdir command. 

■ Using filename shorthand: wildcard characters. 

■ Finding out who can use your directories: directory permissions. 


Organizing Files in Directories 3-1 









What is a Directory Hierarchy? 


Like files, directories are containers. But instead of text or other data, 
directories contain files and other directories. In addition, directories are 
hierarchically organized; that is, a directory has a parent directory “above” 
and may also have sub-directories “below.” Similarly, each sub-directory 
can contain other files and also can have more sub-directories. Because 
they are hierarchically organized, directories provide a logical way to 
organize files. 


Directories are organized into a structure which resembles an inverted tree. 
These directories (shown as ovals) usually contain more directories, which in 
turn enable the branching “tree” structure of a typical home directory: 



Figure 3-1. A Typical Directory Structure 
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Each directory also contains files (represented below as boxes), which hold 
actual text, data, or code. At the top of the inverted tree structure is the root 
directory, represented in path names as /. Figure 3-2 shows a broader part of a 
system’s directory structure. 




(home 

directory) 


Figure 3-2. A System Directory Structure 
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Determining Your Location in an HP-UX Directory Hierarchy 


This section discusses the HP-UX directory structure and how you specify 
the location of a file in the structure. All directories fall under the topmost 
root directory, which is denoted by a slash (/). When you use HP-UX, you 
are working in a directory called the current working directory. And when 
you log in, HP-UX places you in your home directory. 


Figure 3-3 shows the two highest levels of a typical HP-UX directory structure. 
Each directory, including the root, may contain logically-organized files, as well 
as more directories. 



If you want to know more about the contents of Typically, users' 
these directories, refer to the System Administrator home directories 
Manual for your computer. are under here 

Figure 3-3. The HP-UX Directory Structure 

When using fiP-UX, you are always positioned “in” a directory. The directory 
you are performing tasks in is known as your current working directory. 
Moreover, whenever you log in, HP-UX places you in a working directory called 
your home directory. 
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Here is a sample directory hierarchy for a user named Leslie. When Leslie logs 
in, she is in her home directory, leslie. 



Figure 3-4. Leslie’s Home Directory 
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Specifying Files and Directories: Absolute Path Names 

When specifying only files which are in your current working directory, you 
can refer to them just by their file names. But when referring to directories 
and files outside your current working directory, you must use path names, 
which tell HP-UX how to get to the appropriate directory. An absolute 
path name specifies a path from the root to the directory. A relative path 
name specifies a path from your current directory to another directory. 


A path name specifies where a particular file or directory can be found within 
the directory structure by specifying the.directories you need to pass through 
to get there. 

There are two kinds of path names: absolute and relative. 

Absolute Path Names 

Absolute path names specify the path to a directory or file, starting from the 
root directory at the top of the inverted tree structure. The root directory is 
represented by a slash (/). The path consists of a sequential list of directories, 
separated by slashes, leading to the directory or file you want to specify. The 
last name in the path is the directory or file you are pointing to. 

To determine the absolute path to your current directory, use the pwd (print 
working directory) command. The pwd command displays the “path” from the 
root directory to your current working directory. 

Here is an example of an absolute path, displayed with the pwd command: 

$ pwd 

/users/engineers/leslie 

This specifies the location of the current directory, leslie, by starting from 
the root and working down. 
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Figure 3-5 shows the absolute path names for various directories and files in a 
typical directory structure: 



/ users/engineers/sally/projects —^ ^ 

/ users/engineers/sally/reports-* 

Figure 3-5. Absolute Path Names 
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Specifying Files and Directories: Relative Path Names 

You can use a relative path name as a shortcut to the location of files and 
directories. Relative path names specify directories and files starting from 
your current working directory (instead of the root directory). 


You will frequently find it convenient to use relative path names. The following 
table shows some common path name shortcuts. 


Table 3-1. Examples of Relative Path Names 


This relative path 
name ... 

Means ... 


the current directory. 


the parent directory (the directory above the current 
directory). 


two directories above the current directory. 

directory-name 

the directory below the current directory. 


For example, suppose the current directory (as shown in Figure 3-6) is 
/user/engineers/leslie. To list the files in the directory above (which is 
/user/engineers), enter: 

$ Is . . 

arnie leslie sally you get a listing of /user/engineers 

On the other hand, to get a listing of the files in a directory immediately below 
your current directory, simply enter the directory name. For example, to get 
a listing of the files in the projects directory, below the current directory 
/user/engineers/leslie, you would enter: 

$ Is projects 

$ The projects directory is empty! 
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Figure 3-6 shows relative path names for various directories and files starting 
from the current directory, /users/engineers/leslie. 



Figure 3-6. 

Relative Path Names from 
/users/engineers/leslie 
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Creating Directories 


To create a directory, use the mkdir command. To get a directory listing 
that differentiates files from directories, use the lsf command instead of 
Is. 

The mkdir (make directory) command creates a new directory. After you 
create a directory, you can move files into it, and you can even create more 
directories underneath it. For example, to create a sub-directory in your 
current working directory named projects, type: 

$ mkdir projects 

To verify that it worked, you can use either the Is or lsf command. Both 
commands display the new directory, but lsf appends a slash (/) to the end of 
directory names to differentiate them from file names. For example: 

$ Is ' List files, directories in your current working directory. 

myfile projects It worked! 

$ lsf 

myfile proj ects/ The lsf command appends a slash to directory names. 
Figure 3-7 shows the resulting directory structure. 



Figure 3-7. Creating the “projects” Directory 


3-10 Organizing Files in Directories 











The general form of the mkdir command is as follows: 
mkdir new-dir-path 

where new-dir-path is the path name of the directory you want to create. For 
example, to create a new directory named old under the projects directory, 
type: 

$ mkdir projects/old 



Figure 3-8. 

Structure after Creating “old” under the “projects” Directory 


Finally, let’s create one more directory, named new, and verify with lsf: 

$ mkdir projects/new 
$ lsf projects 

new/ old/ Files and directories are listed alphabetically. 



Figure 3-9. Structure after Creating “new” under “projects” 
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Changing Your Current Directory 


Now that you’ve learned how to create directories under your home 
directory, you’re ready to learn how to move into different directories, 
using the cd command. 


Using the cd (“change directory”) command, you can change your current 
working directory. For example, 

$ cd projects 

moves you into the directory projects (which you created in the section 
“Creating Directories”). To verify that you have, in fact, changed your current 
working directory, use the pwd command, which displays your current directory. 
For example, if your home directory was /users/leslie, then, after you run 
the “cd projects” command, pwd would display the following: 

$ pwd 

/users/leslie/proj ects 

When you’re in the new directory, you can list its contents using lsf: 

$ lsf Here are the directories you created earlier. 

new/ old/ 

To move into the directory new under projects, type: 

$ cd new 

$ pwd Verify where you are. 

/users/leslie/projects/new It worked! 

Now if you run lsf, it won’t display anything because there are no files or 
directories under new: 

$ lsf 

$ 

Remember that . . is the relative path name for the parent directory of your 
current working directory. So to move up one level, back to projects, type: 

$ cd . . 

$ pwd Show your current working directory. 

/users/leslie/projects It worked! 
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If you run cd without a path name, it returns you to your home directory as 
the following example illustrates: 

$ cd 

$ pwd Are you back home? 

/users/leslie Yes! 

Experiment with the cd and pwd commands to move around your directory 
structure. If you become lost, don’t panic; just remember that you can run 

$ cd 

to return to your home directory. You can also get to any directory using its 
absolute path name. For example, to change to the projects directory in the 
example hierarchy, enter: 

cd /users/leslie/projects 

Figure 3-10 illustrates how various cd commands change your current working 
directory. The example assumes you’re starting at the directory 
/users/leslie/projects, and that your home directory is /users/leslie. 



Figure 3-10. Effect of Various “cd” Commands 
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Moving and Copying Files between Directories 

The mv command lets you move a file from one directory to another. With 
the cp command, you can copy a file into a different directory. 


Moving Files 


In addition to renaming files, the mv command can be used to move files from 
one directory to another. For example, to move myfile into the projects 
directory, type: 


$ cd 

$ mv myfile projects 

Now verify that it worked: 

$ lsf 
projects/ 

$ lsf projects 

myfile new/ old/ 


Move to your home directory first. 


List your current working directory, 
Where did myfile go? 

Look in the projects directory. 
There’s myfile. It worked! 


Remember that a single dot (.) for a path name represents your current 
working directory. Therefore, to move myfile from the projects directory 
back to your current working directory, type: 


$ mv projects/myfile 
$ lsf 

myfile projects/ 

$ lsf projects 
new/ old/ 


Don’t forget the dot. 

List your current working directory. 
It worked: myfile is back. 

List proj ects. 

The file myfile isn’t there anymore. 


The general form of the mv command is as follows: 


mv from-path to-path 

where from-path is the file name or path name of the file you want to move, 
and to-path is the name of the path where you are moving the file. 


3-14 Organizing Files in Directories 







Copying Files 

To copy a file into a different directory, use the cp command. For example, to 
make a copy of myfile named myfile2 in the projects directory, type: 

$ cp myfile projects/myfile2 

$ lsf 

myfile projects/ The file myfile still exists. 

$ lsf projects 

myfile2 new/ old/ The copy (myfile2,/ is in the projects directory. 

To make a new version of myfile2 named myf ile3 in your current directory, 
type: 

$ cp projects/myfile2 myfile3 
$ lsf 

myfile myfile3 projects/ 

The general form of the cp command is as follows: 
cp from-path to-path 

where from-path is the file name or path name of the file you want to copy, and 
to-path is the path name of the directory or file to which you are copying. 

Caution When moving or copying files, be careful not to destroy an 

existing file. For example, if you type the following cp 
command: 

$ cp myfile3 projects/myfile2 

Then, a copy of myfile3 is moved into proj ects/myf ile2, 
overwriting myf ile2. The previous contents of myf ile2 are 
lost. 

If you copy a file to a directory, even if the directory has the 
same name as the file, the directory will not be destroyed. But 
a file of the same name in that directory would be. 

As a general rule, before using mv or cp, use Is or lsf to 
ensure that the target file name to which you want to move or 
copy doesn’t already exist. 
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Removing Empty Directories 


When you are finished using a directory and it is no longer needed, you can 
remove it using the rmdir command. For example, if you had a directory 
containing 5-year-old files on a long-dead project, you might want to 
remove the files and the directory. Before removing a directory, you must 
remove its files and subdirectories. 

After you’ve removed a directory, you can no longer use it, and it will no longer 
appear in an 11 or other listing. 

But before removing a directory, you must remove its files, as well as any 
directories under it. For example, suppose you want to remove the projects 
directory and the files it contains. Figure 3-11 shows how this structure might 
look: 



Figure 3-11. The “projects” Directory Structure 
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To remove this structure, run the following sequence of commands: 

$ cd Move back to your home directory 


$ lsf 

myfile myfile3 projects/ 

$ rmdir projects 
rmdir: projects not empty 

$ cd projects 

$ lsf 

myfile2 new/ old/ 

$ rm myfile2 
$ lsf 

new/ old/ 

$ rmdir new 

$ lsf 
old/ 

$ rmdir old 

$ lsf 
$ cd 

$ rmdir projects 
$ lsf 

myfile myfile3 


List the files and directories. 

Try to remove projects. 

It won’t let you. 

Change directory to projects. 

List its contents. 

Remove the file myf ile2. 

The file myf ile2 is gone. 

Remove the directory new. If it’s 
empty, rmdir removes it. 

It worked! 

Now remove the directory old. If it’s 
empty, rmdir removes it. 

It worked again! 

Now move back to your home direc¬ 
tory ... 

And remove projects. 

Verify that it worked. 

It worked! 
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File Name Shorthand: Wildcard Characters 


Wildcard characters provide a convenient shorthand for specifying multiple 
file or directory names with one name. Two of the most useful wildcard 
characters are * and ?. The * matches any sequence (string) of characters 
(including no characters), and the ? matches any one character. 


The * Wildcard 

The * wildcard means “any characters, including no characters.” Suppose you 
have created the following files in your current working directory: 

$ lsf 

myfile myfile2 myfile3 xenic yourfile 

To list only the file names beginning with “myfile,” type: 

$ lsf myfile* 

myfile myfile2 myfile3 

Even though xenic and yourfile exist, lsf displays only the file names that 
start with myfile. If you wanted to list file names containing “file,” type: 

$ lsf *file* 

myfile myfile2 myfile3 yourfile 


The ? Wildcard 

The ? wildcard means “any single character.” Although you probably won’t 
use the ? wildcard as much as *, it is still useful. For instance, if you want 
to list only the files that start with myfile and end with a single additional 
character, type: 

$ lsf myfile? 
myfile2 myfile3 

The ? wildcard character matches exactly one character. Thus, myfile didn’t 
show up in this listing because it didn’t have another character at the end. 


3-18 Organizing Files in Directories 








Using the * Wildcard Character with mv, cp, and rm 


Wildcard characters are often useful when you want to move or copy multiple 
files from one directory to another. For example, suppose you have two 
directories immediately below your current directory, named new and old, and 
these directories contain the following files: 


$ lsf new 
myfile myfile2 
$ lsf old 
myfile3 myfile4 


To move all the files from the directory new into the directory old, type: 


The files are no longer in new. 
They are in the directory old. 


$ mv new/* old 
$ lsf new 
$ lsf old 

myfile myfile2 myfile3 myfile4 

You can do a similar operation with the cp command. For example, to copy all 
the files from old into new, type: 

$ cp old/* new 


Similarly, you can use wildcard characters with the rm command. 


Caution Be careful when using wildcards that you don’t accidentally 
remove files you need. 


For example, to remove all the files in the directory new, type: 

$ rm new/* 

$ lsf new 

$ All the files are gone! 


For More Information ... 

See regexp(5) in the HP-UX Reference for general features of * and ?. For 
additional features relating to individual shells: if you use the Korn Shell, refer 
to ksh( 1); if you use the C shell, refer to csh( 1), both in the HP-UX Reference. 


x 
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Displaying Directory Permissions: The II Command 

You can display access permissions for a directory, as for a file, with the 11 
command. To display permissions for a specific directory, use the 11 
command with the -d option. 

To display permissions showing owner, group, and other for a specific directory, 
use the 11 command with the -d option. For example to see the permissions on 
the projects directory below the current directory, type the following: 

$ 11 -d projects Follow the 11 command with a -d and the directory 
name. 

When you press f Return ) , you should see something like this: 

drwxr-x- 1 leslie users 1032 Nov 28 12:38 projects 

The first character (d) in the long listing above indicates that projects is a 
directory. The next nine positions (three sets of three) indicate the presence or 
absence of read (r), write (w), and search (x) permissions for owner, group, 
and other. If a permission is not allowed, a dash appears in place of the letter. 
Here is a closer view with all positions indicated: 

d rwx rwx rwx 


directory owner group other 


Then, in the original example above (drwxr-x-): 

owner (leslie) has read, write, and search permission (rwx); group (users) 
has read and search permission (r-x); other has no access ( ) to the 

projects directory. 
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For More Information ... 

See Chapter 12 of this guide “Making Your System Secure” for information on 
how to change the access permissions on files and directories. 

To learn more about the 11 command, refer to the HP-UX Reference (the 11 
command is listed under Is in section 1 of the Reference). 
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Chapter Command Summary 


Table 3-3. Commands 


To Do This ... 

Type This ... 

List files; show directories with 

Change directory 

Change to home directory 

Display working directory 

Remove an (empty) directory 

Display permissions for a directory 

lsf 

cd directory-path 

cd 

pwd 

rmdir directory-name 

11 -d directory-name 
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Entering Commands: Options, Arguments, 
and Help with Syntax 


HP-UX has many powerful and useful commands. This brief chapter provides 
some background information that will help you to use these commands more 
effectively. 

More specifically, this chapter discusses the following topics: 

■ Understanding command syntax—command options and arguments. 

■ Entering commands with the Key Shell 

■ Displaying on-line HP-UX Reference entries (man pages), if they are 
installed on your system. 
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Understanding Command Syntax 

HP-UX provides a wealth of powerful, versatile commands that can do a 
wide variety of computing tasks. Before delving into these commands, 
though, you should have a general understanding of command syntax. 


Most of the commands you’ve used thus far have been simple in syntax; that 
is, they’ve been either a command without any arguments (whoami), or a 
command whose only argument is a file name (mkdir projects). In actuality, 
commands can be more complex, having additional options, arguments, or 
both. Options change a command’s behavior. (For example, in Chapter 3, you 
used the -a option to change the behavior of the Is command so you could 
list invisible file names.) In general, command options are preceded by a dash 
(-). Arguments provide additional information needed by the command, for 
example, which files to run the command on. 

Examples Using Options 

When used without any options, the rm command removes a file without 
verifying whether you really want to remove it. Suppose, for example, your 
current working directory contains these files: myfile, myfilel, myfile2, 
myf ile3, and myfile4. You could remove all these files by typing this 
command: 

$ rm my* 

$ All the files are removed, no questions asked. 

For safety, if you want rm to prompt you for verification before removing each 
member of a set of files, you can use the -i option: 

$ rm -i my* 

myfilel: ? (y/n) For each file, the system asks if you 

really want to remove the file. Type y 
to remove this file; n to leave it alone. 
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myfilel: 

? (y/n) 

myfile2: 

? (y/n) 

myfile3: 

? (y/n) 

myfile4: 

? (y/n) 

$ Is 


myfile4 



You don’t want to remove this file , after 
all. 

It worked: rm did not remove myfile4. 


If you are using rm non-interactively and the file does not have write 
permission (for example, with 444 permission), then a message “filename: 444 

mode ? (yes/no)” will be displayed. Respond with y if you want to remove 
the file. 
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Entering Commands with the Key Shell 

The Key Shell (keysh) is an extension of the Korn Shell, using softkey 
menus and context-sensitive help to help you with command options and 
syntax. The Key Shell automatically translates softkey commands into 
HP-UX commands when you press [ Return 1 to enter the command line. 


Using the Key Shell Displays 

The Key Shell gives you softkey displays at the bottom of your screen which 
provide a “menu” of basic Korn Shell commands, along with their options in 
sequence. You will first see a status line like the following 


hpfcjdp 


No mail === 09:55:07 AM 


—Help- 


Mail 

[Change 

iList 

hpterm 

[Edit 

[Display 

iPrint 

- 


|dir 

|files 


|f ile 

|f iles 

|files 

|l 


of 4 


Figure 4-1. Key Shell Softkey Display 


You can enter commands from the Key Shell softkey menu or you can 
enter standard HP-UX commands as usual. If you enter standard HP-UX 
commands, the Key Shell will often display an appropriate left-to-right set of 
menu options in the softkey label area at the bottom of your screen. Each label 
corresponds to a softkey, f1 through Ife The hpterm at the center separates 
the softkeys into groups of four. You may select any or none of the options 
successively by pressing the corresponding softkey. 

When you want to see more commands, or more options to go with a command 
you’ve already chosen, press the '“TjMfSi? - softkey, f@:. This will cause the 
Key Shell to display the next “bank” of softkeys in sequence, eventually cycling 
back to the first, if you press f8 repeatedly. 

After you make a selection by pressing a softkey, your choice will appear on the 
command line in “English,” just as it appeared in the softkey display, with the 
correct order and spacing. 
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Entering a Command with the Key Shell 

For example, enter the Is command. You will see the following: 


I* 14 

I=== hpfcjdp === /users/jodi/kegsh ==: 

-Help—(all 

files 


with 

long 

hpterm 

sorted 


follow 

inodes 

format 






—More- 
1 of 2 


Figure 4-2. Options Displayed 


Many softkey commands require that the user enter a parameter or select an 
additional softkey before pressing fRetuml . A “prompt line” underneath the 
command line will indicate whether you need to enter anything else. 
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If you select Is, and then select the “sorted” option, the Key Shell will ask you 
to specify how you want your file listing sorted: 


$ Is sorted | 

Select "alphabetical", "oldest-newest", or "newest-oldest . 


l|—Help—laloha- [oldest- [newest- 1 hpterm 



jbetical |newest |oldest 




Figure 4-3. Required Options Requested 


At any time, you can use the --Help— softkey, f 1 , to find out more about 
what functions are available to you. 

Suppose you have selected “newest-oldest” for th e sort option above. You can 
now enter the finished command line by pressing (Return) . Or, if you want to 
preview the HP-UX commands to which these “English” words correspond, you 
can optionally press ( insert line ) and the HP-UX commands will be displayed as 
shown in Figure 4-4. 


$ Is sorted newest-oldest 
$ Is -Ft | 

=== hpfcjdp === /users/jodi/keysh === No mail === 09:56:13 AM == : 






hpterm 







Figure 4-4. Optional HP-UX Commands Display 
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Customizing Your Key Shell Softkeys 

You can change the Key Shell’s configuration (for example, status line or 
options) using the Keysh.config softkey in the --More-- 4 of 4 display. 
Any changes you make will be automatically saved in the .keyshrc file in your 

home directory. This file will then be replayed upon subsequent invocations of 
keysh. 

If they are not already on, some global options that you can change using 
Keysiccpnfig are: 


Table 4-1. 


To Enable These Options ... 

Enter These Softkeys and Press ( Return) ... 

"--Help-’" softkey 

Automatic prompt messages 

Visible HP-UX command 
translations 

KSySfc.Oonflgj tiptispe |||t|t (He; 

options prompt! <§*' 

INf tranaiatiftnft ||| 


To turn off any of these options, enter iff at the end of the entry sequence 
instead of on . 
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Status-Line Indicators you can change, using the Keysh_config softkey are: 

Table 4-2. 


To Enable Additional 
Status-Line Indicators 

Enter These Softkeys and Press f Return 1 

Host name 

Keysh^oolifig $0 

User name 

Keysh^config shatus^liiii user^nlpi §&•• 

Current directory 

Keysh^^Iiiig 


on 

Mail status 

Keysluconfig sfcatus^line 


on 

Date 

Keysh^config sfcatusJLinG f§J 

Time 

Keysh^config status^line tiifi# #1' 


In addition, the contents of the $KEYSH shell variable, if set, is also displayed 
the status line. 

Restarting and Undoing the Key Shell Configuration Changes 

■ If you want an existing Key Shell to take on the behavior you’ve specified 
in another Key Shell, you will need to enter the following to “replay” the 
current configuration sequence. 

Keysh_config restart 

■ You can undo any configuration changes you may have made since last 
invoking a Key Shell by entering the following command: 

Keysh_config undo 

Pressing undo a second time will “toggle” the configuration back to the 
previous state again, restoring your changes. 
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Summary of Key Shell Procedures 

The general rules for using the Key Shell are: 

■ Select any desired softkeys from left to right. 

■ Use the —More— softkey to see more options. 

■ Optionally, use the [insert line) key to preview the translated command-line. 

■ Use the -Help-- softkey to find out more functions. 

If you make an error, use [Back space) or ( ctrl U Tl to erase the line back to where 
you want to re-enter command text, just as you would with commands in ksh, 
csh, or sh. 

You can also use the arrow keys, [clear line ) , (Delete line ) . (insert Chari , and ( Delete char 1 to 
manipulate your command line, in addition to using the editor which is set for 
your Korn Shell (see Chapter 9). Note that (clear line) functions to delete the line 
only from the cursor position to the end of the line. (Delete line] , however, deletes 
the entire command line and cancels the command. 
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Accessing On-Line Command Help: man pages 

HP-UX commands are documented thoroughly in the HP-UX Reference. 

In addition, HP-UX can also store HP-UX Reference entries (commonly 
known as man pnQes'j on disk. If your system has these on-line man pages, 
you can use the man command to display them on the screen. 

The man (manual) command displays a command’s syntax plus a detailed 
description of the command and its options and arguments (if any). Also, man 
may display examples of command usage and provide other information such as 
system files used, related commands, diagnostics, possible problems (bugs). 

For example, you can use man to learn more about the man command itself. 
After a few seconds, an information display appears: 


$ man man 

MjSMCl) flifftt* 

HAME 

man - find manual information by keywords; 
print out the manual 



man -k keyword ... 
man -f file ... 

man [ - ] [ section ] title ... 

DESCRIPTION 

Man is a program that gives information from the 
HP-UX Reference Manual ... 

—More--(11%) 
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The message —More— (11%) means you’ve viewed 11% of the file, and 89% 

remains. (Some systems will just display f§p|^). At this point, you can do 
any of the following: 

■ Step^ through the file a page at a time by pressing the space bar. 

■ Scroll through the file a line at a time by pressing (Return 1 . 

■ Quit viewing the reference page by pressing Q- 

Note that you can only move forward through a file. 

For details on the syntax for a command, refer to the “SYNOPSIS” section. The 
above example shows, for instance, that the mein command actually has three 
different syntaxes: 

mein -k keyword . . . 
man -f file. .. 

man [ - ] [ section ] title . . . 

The brackets, [ ], indicate that the enclosed parameter is optional. For 
example, when you ran man man in the previous example, you used the third 
syntax, without the optional parameters: 

mein [ - ] [section] title . . . 

You should experiment with using the man command to learn more about the 
various commands we’ve discussed thus far. For instance, to learn more about 
the Is command, type: 

$ man Is 

To learn more about the cp command, type: 

$ man cp 
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Chapter Command Summary 


Table 4-3. Commands 


To Do This ... 

Type This ... 

Delete (remove) a file interactively 

Run several commands on same line 

Show Additional Key Shell choices 

Change Key Shell configuration 

Find HP-UX command information on-line 

rm -i filename 
command ; command2 

K'eyshvCpBflg 

man command-name 
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Using Commands: Syntax, Input, and Output 

HP-UX uses command interpreter programs called shells which help the user 
interact more effectively with the operating system. This chapter introduces 
you to some of the useful features of shells. 

Specifically, this chapter discusses the following topics: 

■ Transferring data among files and programs. 

■ Writing standard output to a file. 

■ Using files for standard input. 

■ Redirecting both standard input and standard output. 

■ Using the output of one command as the input to another: pipes. 
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Transferring Data Among Files and Programs 

The shell interprets your keyboard commands for the HP-UX operating 
system to act on. When you log in, you are said to be in a shell. After 
the shell interprets a command line, HP-UX loads the program that the 
command has specified into memory and begins running it. When a 
program is loaded and running, it is called a process. HP-UX assigns every 
process a unique number, known as a process identifier (PID). 


Programs Create Processes 

When you log in, HP-UX starts your shell. During login, HP-UX copies 
the shell program from system disk into memory. When it is in memory, 
the shell begins executing, and it becomes a process that lasts until you log 
out. Process, then, refers to the copied program that is actively executing in 
memory, while program is the file stored on the disk. 

Similarly, the commands you type create processes. After you type a command 
line, the following events take place: 

1. The shell interprets the command line and searches the disk until it finds 
the requested program. 

2. The shell asks HP-UX to run the program; then control transfers from the 
shell to HP-UX. 

3. HP-UX copies the specified program from a disk file into memory. When the 
program resides in memory, it begins executing and a process is created. 

4. Each process is assigned a Process Identifier or PID. You can find out what 
processes are currently running on your system by typing ps -ef. 

5. When a program finishes executing, control transfers back to the shell, and 
the process disappears. 
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Using Standard Input, Standard Output, and Standard Error 

Each process opens three standard “files”: standard input (stdin), standard 

output (stdout), and standard error (stderr). Programs use these as follows: 

■ Standard input is the place from which the program expects to read its 
input. By default, processes read stdin from the keyboard. 

■ Standard output is the place the program writes its output. By default, 
processes write stdout to the terminal screen. 

■ Standard error is the place the program writes its error messages. By 
default, processes write stderr to the terminal screen. 

Figure 5-1 illustrates the relationship of these files to the process. 



Figure 5-1. 

Standard Input, Standard 
Output, and Standard Error 
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Examples Using the Standard Files 

The following three examples illustrate standard output, standard input, and 
standard error, respectively: 

1. Standard Output 

$ whoami The whoami command begins the process. 
terry Standard output is displayed on the screen. 

$ Control returns to the shell. 

The above example illustrates standard output. In this example, the whoami 
command uses standard output to display the username of the person typing 
the command. The prompt returns, indicating that the shell is ready for 
another command. 


2. Standard Input 


$ sort 
duffy 
muffy 
daffy 
(CTRL)-® 
daffy 
duffy 
muffy 
$ 


The sort command uses standard input. 
Enter standard input at the keyboard. 


End of standard input. 

Standard output is displayed on the screen. 


Control returns to the shell. 


The above example uses the sort command to sort text typed at the keyboard. 
Typing (ctrlK ET) ends standard input. The standard output is displayed on the 
terminal screen. 


5-4 Using Commands: Syntax, Input, and Output 








3. Standard Error 

$ mroe memo You have misspelled a command. 

mroe: not found Standard error is displayed on the screen. 

$ _ Control returns to the shell. 

The standard error example illustrates what happens if you misspell a 
command. The typing error causes the shell to generate an error message that 
is sent to standard error. Again, the prompt returns, indicating that the shell 
is ready for another command. 

For More Information ... 

Your shell has many productivity-enhancing functions that you may find useful 
after you ve mastered the basics. To learn more about the shell processes, 
including the standard files, see Chapters 9 and 10, and refer to Shells: User’s 
Guide. 
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Writing Standard Output to a File 

The shell lets you redirect the standard output of a process from the screen 
(the default) to a file. Redirecting output lets you store the text generated 
by a command into a file; it’s also a convenient way to select which files or 
devices (such as printers) a program uses. To redirect a process’s output, 
separate the command and the output file name with a greater-than sign 
(>) pointing from the command to the output file. To append the output 
to an existing file, use two greater-than signs (») pointing to the file to be 
appended on. 


Redirecting Standard Output 

You can use output redirection with any command that writes its output 
to stdout (your screen). You can redirect output either to a new file or to 
an existing file. To redirect output, use a greater-than sign (>). The word 
following the sign identifies the file name where the stdout data is to be 
written. If the file exists, its previous contents are lost. If the file does not 
exist, it is created. In its simplest form, the command syntax is as follows: 


command > outfile 

where command is the command whose output is redirected, and outfile is the 
name of the file to which the process writes its standard output. 

The example below shows output redirection using the who command, which 
displays a list of users currently logged in to the system. Instead of displaying 
the users on the terminal screen, the output is redirected to the file whoison. 
The more command lists the contents of the whoison file, showing that the 
output redirection was successful: 

$ who > whoison Redirect output to whoison. 

$ more whoison Display contents of whoison. 


pat 

console 

Oct 

9 

08:50 

terry 

ttyOl 

Oct 

9 

11:57 

kim 

tty02 

Oct 

9 

08:13 


$ 
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Figure 5-2 illustrates where stdin, stdout, and stderr go when output is 
redirected to a file. 



out file 


Standard Input, Output, and Error When 
Output Is Redirected 


Appending Output to a File 

Output redirection that appends to an existing file uses two greater-than signs 
(»). The word following the redirection sign identifies the file to which stdout 
data is appended. If the file exists, the new data is appended to the end of the 
file. If the file does not exist, it is created. The command syntax is: 


command » outfde 

where command is the command whose output is redirected, and outfile is the 
name of the file to which the process appends the standard output. 

The next example executes the date command with the output redirected to 
append to the whoison file: 


$ date >> whoison 
$ more whoison 


pat 

console 

Oct 

9 

08:50 

terry 

ttyOl 

Oct 

9 

11:57 

kim 

tty02 

Oct 

9 

08:13 

Tue Oct 

9 13:20:16 

MDT 1990 




$ 


Append output to whoison. 
Display contents of whoison. 
Output from previous example. 


Newly appended output from 
date. 


Using Commands: Syntax, Input, and Output 5-7 



















Using Files for Standard Input 

The shell lets you redirect the standard input of a process so that input is 
read from a file instead of from the keyboard. To redirect the input of a 
process, separate the command and the input file name with a less-than 
sign (<) directed at the command name. 


Your shell can redirect the data flow into a program so that the keyboard is 
not used. Input that is normally typed at the keyboard can be redirected to be 
read from a file. You can use input redirection with any command that accepts 
input from stdin (your keyboard). You cannot apply input redirection to 
commands such as who that do not accept input from stdin. 

To redirect input, use a less-than sign (<). The word following the sign 
identifies the file from which the stdin data is read. The file must exist for the 
redirection to succeed. In its simplest form, the command syntax is as follows. 


command < infile 

where command is the command whose input is redirected, and infile is the 
name of the file from which the process reads standard input. 

The following example illustrates input redirection. First, standard output 
from the who command is redirected to a file named savewho. Second, the more 
command displays the contents of savewho. Finally, standard input for the wc 
(word count) command is redirected to come from the savewho file: 


$ who > savewho 
$ more savewho 


pat 

console 

Oct 

9 

08:50 

terry 

ttyOl 

Oct 

9 

11:57 

kirn 

tty02 

Oct 

9 

08:13 

kelly 

tty04 

Oct 

9 

10:04 

$ wc -1 < 

savewho 





4 

$ 


Redirect output to savewho 
Display contents of savewho 


Redirect input from savewho 
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In the preceding example, the wc command with the -1 option counts the 
number of lines in the input file. Because input is redirected from savewho, 
this number equals the number of users logged in to the system when the who 
command was executed. 

Figure 5-3 illustrates where stdin, stdout, and stderr are directed when 
input is redirected from a file. 



Figure 5-3. 

Standard Input, Output, and Error 
When Input Is Redirected 
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Redirecting Both Standard Input and Standard Output 

You can redirect both the standard input and the standard output of a 
single command. However, do not use the same file name for standard 
input and standard output. When input and output operations use the 
same file, the original contents of the input file are lost. 

Using the Default Standard Input and Standard Output 

The following example uses the sort command to sort text typed at the 
keyboard. Typing [ctrl}-© ends standard input. The standard output displays 
on the terminal screen as follows: 


$ sort 
muff y 
happy 
bumpy 


End of standard input. 


{CTRL ) -fF) 


bumpy 
happy 
muff y 
$ 


End of standard output. 


Redirecting Standard Input 

In the following example, input is redirected: 


$ more socks 
polka dot 
argyle 
plaid 

$ sort < socks 


Display contents of socks. 


Redirect input from socks and sort the 
contents. 


argyle 
plaid 
polka dot 
$ 
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In the preceding example, the sort command uses a file named socks as input. 
As with the first example, the standard output displays on the terminal screen. 


Using Both Standard Input and Standard Output Redirection 

The next example combines both input and output redirection: 


$ sort < socks > sortsocks 
$ more sortsocks 
argyle 
plaid 
polka dot 
$ 


Use both input and output redirection. 
Display contents of sortsocks. 


In this example, the sort command reads input from the socks file and writes 
output to the sortsocks file; thus, standard output (unlike the first two 
examples) does not display on your screen. 


Figure 5-4 illustrates where stdin, stdout, and stderr are directed when both 
output and input are redirected from and to files. 



Figure 5-4. Redirecting Both Input and Output 
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Using the Output of One Command as Input to Another: 
Pipes 

The shell lets you connect two or more processes, so the standard output of 
one process is used as the standard input to another process. The 
connection that joins the processes is a pipe. To pipe the output of one 
process into another, you separate the commands with a vertical bar (I). 


In previous sections, you were shown how standard output and standard input 
are redirected to and from files. Using a pipe, output from one command is 
sent directly to another command as input. A pipe can link any two programs, 
provided the first program writes its output to stdout and the second program 
reads its input from stdin. The general syntax for a pipe is as follows: 

commandl I command2 

where commandl is the command whose standard output is redirected or 
piped to another command, and commands is the command whose standard 
input reads the previous command’s output. You can combine two or more 
commands into a single pipeline. Each successive command has its output 
piped as input into the next command on the command line: 

commandl \ commands I ... I commandN 

You can use pipes whenever you want one command to use the output of 
another command. In the following example, output from the who command is 
again stored in the file savewho. Then, the savewho file is used as input to the 
wc command: 

$ who > savewho Redirect output of who to file savewho. 

$ wc -1 < savewho File savewho is input to wc command. 

4 Sample result. 

With a pipeline, these two commands become one: 

$ who I wc -1 
4 
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As this example illustrates, using pipes eliminates the need for temporary 
intermediate files. Instead, the standard output from the first command is sent 
directly to the second command as its standard input. 


Using the tee Command with Pipes 

The tee command lets you divert a copy of the data passing between 
commands to a file without changing how the pipeline functions. The example 
below uses the who command to determine who is on the system. In the 
example, which is further illustrated in Figure 5-5, the output from who is 
piped into the tee command, which saves a copy of the output in the file 
savewho, and passes the unchanged output to the wc command: 


$ who 

1 tee savewho | 

1 wc -1 




4 




$ more 

savewho 




pat 

console 

Oct 

9 

08:50 

terry 

ttyOl 

Oct 

9 

11:57 

kim 

tty02 

Oct 

9 

08:13 

kelly 

tty04 

Oct 

9 

10:04 


$ 


stdout stdout 




Figure 5-5. Standard Input and Output with Pipes and tee Command 
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Chapter Command Summary 

Table 5-1. 


To Do This ... 

Type This ... 

Redirect (save) standard output to a file 

Append standard output on a file 

Redirect input from a file to a command 

Redirect both standard input and output to a file 
Connect (“pipe” between) two process 
Simultaneously file command output and send to 
another command (“tee”) 

command > outfile 
command » outfile 
command < infile 
command < infile > outfile 
commandl I command2 
commandl 1 tee file 1 
command2 
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Writing and Editing with the vi Screen Editor 


As you look through this chapter, you will learn how to use vi to do the 
following tasks: 

■ Use the keyboard with vi.. 

■ Enter commands versus type text (the vi modes). 

■ Do essential tasks with a file. 

■ Enter and delete text and undo a command. 

■ Move and copy text 

■ Save and print a file; exit vi. 

■ Move the cursor. 

■ Scroll through text. 

■ Find text patterns. 

■ Replace and substitute characters. 

■ Use options to change your vi environment. 

■ Make your vi environment permanent. 

You will probably want to refer to the vi Editor Quick Reference which you 
can tear out of the front of this manual. 
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Using the Keyboard with vi 

The vi “Visual Interactive” editor has two basic modes for manipulating text: 

■ Command mode 

■ Text entry mode 

When you enter vi, you will be in command mode until you enter one of the 
text entry codes, such as i, a, s, or o, which are explained in this section. In 
text entry mode, you can backspace and type over text you have just entered 
(by pressing ( ctrl | -h or f Back Space 1 ) . But, if you want to move around otherwise 
in your text and execute other text-manipulation commands, you will have to 
press f esc 1 to return to command mode. 

If You Make Mistakes 

Use the following procedures to correct mistakes: 

■ If you type an error while entering text, press f Back space ) to back up over the 
error, and then re-type the correct text. 

■ If you type several errors and cannot recover, exit vi without saving the file, 
and start over. To do this, press fiscl - Then type: 

: q! f Return ) 

■ For other situations, see the section “Undoing Mistakes,” later in this 
chapter. 
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A Note about Letter Case 

When you enter commands in vi, letter case (caps or small letters) does 
matter. For example, lowercase i and uppercase I represent two different 
comm ands. Therefore, if the cursor doesn’t move as it should, make sure the 
(c^T) key isn’t locked on, or see your system administrator. 
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Overview: Entering Commands vs. Entering Text 

The vi editor lets you either type text or type commands. Because vi 
doesn’t let you do both at the same time, you will find yourself alternating 
between two modes. You type text in text-input mode. You type 
commands, move the cursor, set options, and exit vi in co mma nd mode. 

To return to command mode from text-input mode, press (esc] . 


To enter vi, type vi followed by a space and the name of the file you want to 
work with (either a new one or one that already exists). You automatically 
enter vi in command mode —which means you can type commands, but you 
can’t type text. 

For example, you can type commands to move the cursor or to exit vi. To 
begin typing text, press a key such as Q that lets you enter tex t. W hen you 
finish typing text and want to type commands again, press the (esc] key. 


Distinguishing between Modes 

If you aren’t sure which mode you are in, press (esc) : 

■ If you are in text-input mode, pressing fisc] puts you into command mode. 

■ If you are already in command mode, pressing fisc) should make your 
terminal beep, if it is so equipped. 

The : set showmode option offers an alternative way to distinguish between 
modes. Setting this option usually displays an INPUT MODE message at the 
bottom of your screen each time you enter text-input mode. 

If you use the showmode option, set it each time you enter vi. To set the 
showmode option, press (esc) to ensure you’re in command mode, and then 
type: 

: set showmode (Return 1 

Typing a colon (:) while in command mode opens a command line at the 
bottom of your screen. The text you type after the colon is a command. 
Execute the command by pressing ( Return ] . 

To undo the showmode option, type: 
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:set noshowmode (Return) 


Text Input Mode: Entering Paragraphs 

When you are in text-inp ut mod e, vi requires you to end each line by pressing 
(Return). If you don’t press [Return ) , the line wraps (continues) to the next line— 
without neatly breaking words. Not entering carriage returns eventually results 
in the following error message: 

Line too long 

If you receive the above error message, type: 

Vi (Return ) 

After you type vi [Return ) , the line on which you were working will be lost. 

If you don t want to insert carriage returns, use the : set wrapmargin option. 
This option inserts carriage returns automatically. The wrapmargin option is 
most useful when typing paragraphs, not when typing computer programs. 

To remove carriage returns, position the cursor on the line having the return 
character at the end and press Q). The J command “joins” lines of text. 

Set the wrapmargin option each time you enter vi. To set the wrapmargin 
option, press (esc) to ensure that you’re in command mode, and then type: 

: set wrapmargin=n ( Return 1 

The n represents a number that you specify and determines the size of the 
right margin (the default is zero). For example, to set a 72-character line on an 
80-character display, type: 

:set wrapmargin=8 

To undo the wrapmargin option, type: 

:set wrapmargin=0 

For a more detailed discussion of the showmode and wrapmargin options, and 
how to avoid having to set options each time you enter vi, please refer to the 
later sections in this chapter, “Using Options to Change Your vi Environment” 
and “Making Your vi Environment Permanent.” 


Writing and Editing with the vi Screen Editor 6-5 













Doing Essential Tasks with the vi Full-Screen Editor 

1. First, log in. When you see the HP-UX prompt (usually $ or %), type: 

$ vi sample_file [ Return ) 

You should soon see the following screen, with the cursor at the top left (vi 
is in command mode when you enter): 


"sample file" [New file] 


If your screen does not look like the above example, you may have entered 
an existing file. Type :q! if you wish to leave vi and return to the HP-UX 
prompt. 

2. Press Q (“insert before the cursor”) to start entering text in vi. You are 
now in text-input mode. The screen will not regi ster an y command-mode 
input, so press the key only once. (Do not press (Return) .) 
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3. Type the following text as it appears. Note the mistakes and include them; 
you will c orrect them later. If you type a mistake of your own, use the 
(Back space) key to move back over the incorrect text, and then retype it. 

Type this sample text. (Return) 

The second lin contains one error. (Return) 

The third line is fine. (Return] 

But the fourth line cotains two misstakes. 

4. Press (esc) (the escape key). Pressing fisc] means you can no longer enter 
text. Instead, you can command the cursor to move within the file (that is, 
you are in command mode). If you aren’t sure whether you are in text-entry 
mode or com mand mode, press (esc ) . If you were already in command mode, 
pressing (esc) should make your terminal beep (if your terminal does not 
have audio, pressing (esc) still puts you in command mode). 

5. Type :wq (Return) Typing a colon (.) while in command mode opens a 
command line at the bottom of your screen. The colon and the rest of 
your command (in this instance wq) appears in this command line. When 
you type the :wq command, the :w writes sample-file to a disk (saves the 
changes); the q tells vi to quit. 

6. Re-enter samplefile to correct the mistakes by typing this command: 

$ vi sample_file ( Return) 
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This command is the same as before, but instead of opening a new text file, 
vi finds the existing file called sample-file. The screen clears, and you see 
something like this: 


Type this sample text. 

The second lin contains one 
The third line is fine. 

But the fourth line cotains 


error. 

two misstakes. 


"sample.file" 4 lines, 125 characters 


■ To correct the two mistakes (cotains and misstakes ) in the fourth line, do 

the following: 

1. Press 0 three times to move the cursor down to the first character in the 
fourth line. 

2. Press 0 (lowercase L) to move the cursor right. Press 0 several times 
until the cursor is at the t in cotains. (On most keyboards, holding down 
a cursor movement key moves the cursor until you release the key.) If you 
pass t, press (T) to move the cursor left. 

3. Press 0 to insert text before the cursor. 

4. Type in the n to spell contains correctly. 

5. Press fisT) . Pressing fisT) puts you back in command mode, letting you 
move the cursor without entering text. 
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Next, correct misstakes, which also is in the fourth line: 

1. Press Q (lowercase L) until the cursor is at the first s in misstakes. 

2. Press Q (lowercase x) to delete the extra s. If you make mistakes, such 
as deleting more than one character, press (?) (uppercase U) to undo all 
the changes you made to that line. After deleting text, you don’t need to 
press (esc) because you haven’t left command mode. 

Now, correct the mistake (lin) in the second line: 

1. Press 0 twice to move the cursor up to the second line. The cursor 
should be at the end of the second line. 

2. Press 0 to move the cursor left. Position the cursor at the n in lin. If 
you pass the n, press Q (lowercase L) to move the cursor right. 

3. Press 0 to append text after the cursor. 

4. Type e to spell line correctly. (Whatever you type is added to the text, 
until you press (esc) again.) 

5. Press (esc ) to exit text-entry mode and re-enter command mode. 
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■ You have now corrected the mistakes in sample-file and are ready to exit vi. 
You can exit vi in one of two ways: 

1. To exit vi saving your corrections, type :wq (Return) . 

2. To exit vi without saving your corrections, type :q! (Return) . 


6 
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Summary of vi Essentials 

You should now know how to enter vi, enter text, move the cursor, make 
corrections, and exit vi—with or without saving the text. The table below 
summarizes the basic commands. 

Table 6-1. vi Essentials Summary 


To Do This ... 

Type This Command ... 

Enter vi and create, or use existing, sample-file. 

vi sample-file ( Return) 

Insert text before the cursor. 

i 

Exit text-entry mode and return to command 
mode. 

fisc~) 

Write the file and then quit vi. 

: wq f Return ) 

Move the cursor right. 

1 or 0 

Move the cursor left. 

hor@) 

Move the cursor up. 

k or Q 

Move the cursor down. 

j or Q 

Append text after the cursor. 

a 

Delete one character. 

X 

Exit vi without saving changes. 

: q ! (Return ) 


You have now gone through most of the essentials for doing basic tasks in vi 
The next sections will give you more details about using this highly versatile 
editor, beginning with the section “Entering, Deleting, and Undoing”. 
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Entering, Deleting, and Undoing 

The vi editor offers various ways to enter text. You can insert text before 
the cursor, append text after the cursor, or open new lines for inserting 
text either above or below the cursor. When you finish typing text, press 
(esc) to end text entry mode and return to command mode. See Table 6-2 
and Figure 6-3 for summaries of the text-entry commands described in this 
section. 

The commands that let you enter text are the following: 


Table 6-2. 


To Do This ... 

Type 

This ... 

Insert text before the character that cursor is on. 

i 

Insert text before the first character of the line. 

I 

Append text after cursor. 

a 

Append text at the end of the line. 

A 

Open a blank line below cursor for text entry (lower-case o). 

0 

Open a blank line above cursor for text entry (upper-case 0). 

0 


opens newline above 

0 


Cursor 


inserts at beginning 

I - 


r t 

L. J 


a appends after cursor. 


/ 


Inserting [tjext commands. 

:: t 


t 


opens newline below. 


inserts before cursor. 


appends at end of line. 


Figure 6-1. Using the Text-Entry Commands 
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Deleting Text 

In vi, you can delete text by character, word, or line. You can also delete text 
from the cursor back to the first line of text and from the cursor forward to the 
last line of text. Use delete commands only in command mode. 

The following table summarizes the delete commands. 


Table 6-3. 


To Delete ... 

Type This ... 

Character at cursor. 

x 

n characters, starting at the cursor. 

nx 

From cursor to beginning of next word or first punctuation. 

dw 

From cursor to beginning of next word. 

dW 

From cursor to beginning of nth word or punctuation. 

ndw 

Current line. 

dd 

The next n lines, including current line. 

ndd 

From cursor to end of current line (deletes character at cursor). 

d$ 

From cursor to beginning of current line (leaves character at cursor). 

dO (zero) 

All lines to beginning of file, including current line. 

dlG 

All lines to end of file, including current line. 

dG 


deletes from cursor deletes from cursor 

to beginning of line. to end of line 


dO 


d$ 


Deleting [tjext in a 

1 


Cursor 


dw 

deletes one word. 


deletes character at cursor. 



dd 

deletes entire line. 


Figure 6-2. Using the Delete Commands 
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Undoing Mistakes 


The u undo command (lower-case u) reverses the last change made to your 
text. The U undo command (upper-case U) reverses all the changes made 
to a single line since you began editing that line. Typing :q! exits vi 
without saving the text. Use these commands only in command mode. 


6 
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The following table summarizes the commands 
mistakes: 


you can use to recover from 


Table 6-4. 

To Do This ... 

Type 
This ... 

Undo either the last command executed or the last 

characters typed. 

u 

Restore the current line to its state before the last 
edits. 

U 

Exit vi without saving changes. 

•*q! 
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Moving and Copying Text 

One of the more useful tasks you can do with the vi text editor is to take a 
piece of text to another place in the file, or copy a piece of text to one or 
more other locations. 

To move a block of text from one location to another, use the delete and 
put commands. To copy a block of text from one location to another, use 
the yank and put commands. 


To move text from one location to another, follow these steps. 

1. Press fiscl to enter command mode. 

2. Delete, with a single delete command, all the text you want to move. A 
line-delete command can be used with multiple lines by preceding it with 
the number of lines you want to delete, ndd. Other delete commands can 
also be used. After deleting the text, don’t execute any commands but 
cursor-movement commands until you’re ready to restore, or “put” the text 
in another location. 

3. Move the cursor to the location where you want to put the text you just 
deleted. 

4. Execute a put command p, which places the deleted text below the cursor, if 
you have used line delete, dd. 
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An Example of Deleting and Putting Text 

For example, suppose you have the following text, where Line Two is in Line 
Four s place and This is misspelled: 

This is Line One. 

This is Line Three. 

This is Line Four. 
hTis is Line Two. 

To move Line Two to its place between Lines One and Three, execute the 
following steps (if you make a mistake, type u to undo the mistake. 

L Place the cursor anywhere on Line Two {hTis is Line Two), and type dd 
This command deletes the entire line. 

The sample lines now look like this: 

This is Line One. 

This is Line Three. 

This is Line Four. 


2. Move the cursor up, and position it anywhere on Line One. 

3. Type p (lower-case p) to put the deleted text after Line One. The cursor 
should be at the first character (k) of Line Two (hTis is Line Two) The 
text now looks like this: 

This is Line One. 
hTis is Line Two. 

This is Line Three. 

This is Line Four. 

4 ' 1° C °u» eCt the trans P° sition error (hTis) in Line Two, place the cursor on 
e h and, also in command mode, type xp. Typing x deletes the h ; 
typing p puts the h after the cursor. 
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Copying Text Without Deleting 

To copy text, and place it at one or more other locations without deleting the 
first occurrence, follow these steps: 

1. Press fisc) to enter command mode. 

2. Position the cursor on the first line of the text you want to copy. 

3. Type yy (or nyy, for multiple lines) to copy (or “yank”) the text you want 
to move. 

4. Move the cursor to the location where you want to put the yanked text. 

5. Type p (lower-case p) to put yanked text below the cursor. 

6. If you wish, you can then move the cursor to yet another location and 
put the same text there. As long as you haven’t executed any intervening 
commands, the text remains in the put buffer. 

An Example of Yanking and Putting 

For example, suppose you have the following four lines of text. 

This is the First Line of text you want to copy. 

This is the Second Line. 

And the Third Line. 

This is the Final Line of text you want to copy. 

To duplicate the above lines of text immediately after the original lines, 
execute the following steps: 

1. Position the cursor anywhere on the First Line. 

2. Type this command to copy the four lines of text: 

4yy 

3. Move the cursor down to the Final Line. 

4. Type p (lower-case p) to put the copied lines of text immediately after the 
Final Line. 
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The lines of text now should look like this: 

This is the First Line of text you want to copy 
This is the Second Line. 

And the Third Line. 

This is the Final Line of text you want to copy 
This is the First Line of text you want to copy 
This is the Second Line. 

And the Third Line. 

This is the Final Line of text you want to copy. 
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Saving Text, Printing, and Exiting vi 

While editing, it is good practice to save the text you are working on. You 
should do this fairly often in order to protect yourself from accidental loss 
of a significant amount of data. You may want to save it either to your 
current text file or to a different text file. When finished editing, you can 
exit, saving changes or not. You will use the : (colon) command line at the 
bottom of the screen to execute saves and to “escape to a shell” in order to 
print a file. Table 6-10, at the end of this chapter, summarizes the 
commands to save text and to exit vi. 

Save frequently during editing sessions—particularly after each significant , 
change. To save during an editing session, first press (esc) to ensure that you re 
in command mode, and then type: 

: W [ Return ) 

Typing a colon (:) while in command mode automatically opens a command 
line at the bottom of your screen. The text you type after the colon is a 
command. Press fReturn) to execute the command. 

Saving to a Different File 

To save to a different text file, use the following command: 

:w file-name ( Return ) 

For example, suppose you are editing a file called practice , and want to save 
the text to a file called practice.trap. Type: 

:w practice .tmp ( Return ] 

vi saves the text from practice (the file you are currently editing) to 
practice.tmp. Your original practice file remains as it was the last time you 

saved to it. 

If the text file you specify for file-name doesn’t exist, vi creates the file. If the 
file already exists, this error message appears at the bottom of your screen: 

File exists - use "w! file-name " to overwrite 
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To .overwrite (replace) the contents of file-name with the file you're currently 
editing, re-type the command as follows: currently 

.w! file—name (Return ) 


Saving Part of a File 

To save part of your current text file, to filename, use this command: 

'■ x >y w file-name (Return) 

where x y represents specific line numbers. You can read the line number 
where the cursor is located by pressing (ctrl>(g). 

^tTpe- 6 ’ t0 SaVe HneS 20 thr ° Ugh 74 ° f y ° Ur CUrrent t6Xt fiIe to a file called 

: 20,74 w temp 

To overwrite (replace) the contents of file-name, type a “!” after the w: 

* w! fUC—TlCLTHC (Return) 


To append (add) the contents of part of your file to another file, file-namel 
without overwriting that file, use the line numbers as above and type » after 

:x,y w >> file-name (r eturn ) 
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Printing a File 

The vi editor does not support printing a file directly, nor will it directly 
activate other HP-UX commands while you are working within a file. However 
instead of leaving and re-entering vi, it is possible to escape to a shell and to 
work temporarily in the system environment. One use of the shell escape 
printing a file, either the one you are currently in or another one. 

To print a file from within a vi file, press (esc) and : (colon), as though 
you were going to type a colon command. Then type ! and the appropna e 

command. 

For example, to print your current file, enter the following: 

: ! Ip */. 


To print any file, enter: 

: ! Ip filename 

Be sure you include the path with the filename, if the file is located outside 
your current directory. 

The lp program gives you a message confirming your printing job number To 
resume work, press fi^T) when you are prompted to do so. Your cursor will be 
at the same place you left it. 
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Exiting vi 

When you want to exit vi, you can either save or not save your changes: 

■ To exit vi saving the text and all your changes, type: 

: WC[ ( Return 1 

■ To exit vi without saving your changes, type: 

• C[! ( Return ) 
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Moving the Cursor 

When you are in command mode, vi provides various ways to move around 
in a file. For example, the keys 0, Q, © and 0 (lower-case L) move e 
cursor left, down, up, and right, respectively. Most terminals let you use 
the arrow keys (the keys marked Q, ©, ©, and ©) to perform the same 
function. If the cursor doesn’t move as you believe it should, make sure t 
(c^D key isn’t locked. Table 6-5 summarizes many of the cursor-moving 
commands; some of these commands are illustrated in Figure 6-3. 


Moving the Cursor to a Specific Line 

A useful cursor-moving command is G, which functions as a “goto” wmmand 
To illustrate, suppose you are editing a file and want to go to line 799 ofthat 
file Type 799G. The cursor moves to line 799 (you don’t need to press (Retu mjj. 
Similarly, to go to line 1 of the file, type 1G. (Note: To find your current line 
number, press 0 FrQ-(g); to display line numbers along the left margin of your 
file, type : set number.) 


To move the cursor to the last line, simply type G. 


6-24 Writing and Editing with the vi Screen Editor 









Table 6-5. Moving the Cursor Up, Down, Left, and Right 


To Move the Cursor 

Type This ... 

Left. 

h or 0 

Down. 

j or Q 

Up. 

k or Q 

Right. 

1 or 0 

To end of current line. 

$ 

To beginning of current line. 

0 (zero) 

To first character in current line. 

(zero) 

To beginning of next word or next 
punctuation 

w 

To last line of file. 

G 

To specific line of text. 

nG 

To the point of previous change. 

” (two single 
quotes) 


^Xe ti rke™^r men ‘ comm “ ds ' try moving the CUrSOr ° n a 


With 

/ move 


I—I I—I I—I 
I—I I—I LJ 


t 


0 


Open 

t 


A 


a 


the 

the 


cursor 

cursor 


here, the commands 
to the position shown. 


I 




E w 


to try these. 

T 

w 


t 


Figure 6-3. Moving the Cursor 
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Scrolling through Text 

In vi you can scroll backward or forward by line, half-scree n, or f ull-screen. 
To scroll, type the appropriate key while holding down the (ctrlJ key. 
Execute scrolling commands only in command mode. Table 6-6 
summarizes the scrolling commands. 


Scrolling moves the cursor backward or forward through the text, so you can 
view various lines or sections of text. Scrolling backward lets you view lines 
toward the first line of text. Scrolling forward lets you view lines toward the 

last line of text. 

To execute the scrolling comman ds, pr ess fisc] to ensure that youre in 
command mode. Then press the [ctrl] key and, while holding gTpdown, 
type the appropriate command key-much like holding down the (shift) key and 
typing the key you want to capitalize. 

(This guide describes the default fern] key commands. Depending on 
your terminal type, commands that use the (cm) key may not function as 
described. If you have problems, see your system administrator or refer to 
HP-UX System Administration Tasks.) 

You may want to open a practice file and experiment with the scrolling 
commands so you can become familiar with them. Refer to Table 6-6 for a 
summary of these commands. 

Note • Some terminals have a key labeled fftjgT) or (ireT), which pages backward, 
and a key labeled fp age Po^Tl or (^), which pages forward. You may prefer to 
use these keys in addition to conventional keyboard scrolling commands. 


Scrolling by Full-Screen 

Among the most useful scrolling commands are two which cause the display 
to scroll backward or forward a full screen, while the cursor takes a constant 
location on the screen: 

■ fcTRLV nn scrolls backward one full screen, so you are one screen closer to the 
beginning of your file. The cursor remains on the bottom line of your screen. 
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el^ouTfife TIT" ° ne M1 SCreen ’ S ° y ° U ^ ° ne SCreen closer to the 
end ot your file. The cursor remains on the top line of your screen. 


Table 6-6. Using the Scrolling Commands 


To Scroll ... 

Type This ... 

Backward to previous screen. 

Forward to next screen. 

(CTRL HD 
[CTRL MT) 
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Finding Text Patterns 

You can search through your vi file for a particular word or words or a 
sequence of characters. To search forward from the cursor, type a slash (/) 
followed by the pattern you want to find. To search backward from e 
cursor, type a question mark (?) followed by the pattern you want to find. 

Table 6-7 illustrates some sample search patterns. 

To search forward from the current cursor position, use this command: 

/pattern ( Return ) 

where pattern represents the specific sequence of characters you want to search 
for. 

To search backward from the current cursor position, use this command: 

? pattern f Return ) 

When you press f Return") , vi searches for the pattern you specified. If vi finds 
the pattern, it positions the cursor at the first character in the pattern 
sequence. For example, to search forward for the word “place,” type: 

/place f Return ) 

If vi finds “place,” it positions the cursor at the “p.” To search for additional 
occurrences of “place,” press either Q or (©• 

■ Q continues searching in the same direction for place, 
m © reverses the direction of the pattern search. 

If vi does not find the pattern you specified, it displays the following message 
at the bottom of your screen, and the cursor isn’t moved: 

Pattern not found 
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Searching for Special Occurrences 

^i™, eXa ™^ Ie ,’ V1 finds any sec l uence containing the pattern “place,” 
including displace, placement,” and “replaced.” 

‘ Jft S’ l7‘ e W ° rd “ place ’’ ? pe the patto " wm a space before and 
alter it (the U represents a space): 

/UplaceU (g) 


witha d caret e ( C ') CUrring ^ ^ beginning of a line ' P re cede the pattern 


/ place (Return ) . 

■ doiia: d S ig:T*r currins oniv at the md ° fa ime ' foiiow the pattern with a 


/place$ (Return 1 . 

To search literally for such a character as a caret (*) or a dollar sign ($) 

precede the character with a backward slash (\). The backward slash tells vi 
to search for a special character. 

Special characters are those (such as a and . ) that have special 

— « r V1 ' F °", 6 f amp e ’ a $ normall y means “go to the end of the line,” 
but if he Preceded immediately by a \, the $ is simply another ordinary 
character. Table 6-7 shows examples using the \. 


Table 6-7. Example Pattern Searches 


Sample Pattern 

Explanation 

/UtestU ( Return 1 

Searches backward for the word test. The spaces 
(represented in this table by U) require that test not be 
part of another word. This search will not find test if it is 
followed by punctuation. 

/(JNo \$ money) ( Return 1 

Searches forward for the pattern (No $ money). The escape 

character (\) immediately preceding the $ tells vi to search 
literally for a dollar sign. 
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Replacing and Substituting Characters 



In previous sections, you learnec 
correct it. Now you can use a rt 
characters and to correct errors 
mode. 


i. Use these commands only in command 


Replacing Single Characters 

To replace a single character of text, press (Isc) to enter command mode, 
position the cursor over the character you want to replace, and type r 
(lower-case r) while in command mode. Then type the replacement character 
The r command lets you substitute only one character. After you have 
replaced the character, you are back in command mode. 

The table below illustrates the r command: 


Original Text 

Keystrokes 

Modified Text 

This wors needs correcting. 

rd 

This word needs correcting. 


Substituting Characters 

To substitute one or more characters for a single character , type s (lower-case 
s) while in command mode. Unlike the r command, the s command lets you 
substitute more than one character for a single character. 

When you type the s command, a dollar sign {$) appears in place of the 
character. After you type the desired character (or characters), press (escJ. 

To substitute several original characters with different characters, precede the s 
command by the number of characters you want to substitute. 

The table below illustrates the s command: 
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Original Text 

Keystrokes 

Modified Text 

Here £s some sample text. 

Edit this lines. 

sWA [esc! 

2sREE (esc 1 

Here WAs some sample text. 

Edit thREE lines 


The table below summarizes the replace and substitute commands, 
want to open a practice file and experiment with these commands. 


You may 


Table 6-8. How to Modify Text 

To Do This ... 

Type This ... 

Replace the single character in the cursor position with one new 

character. 

r character 

Substitute one or more characters for the existing character(s). 

s characters (esc] 

Substitute characters for the existing n character(s). 

n&characters (esc) 
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Using Options to Change Your vi Environment 

To affect the overall operation of vi, you can set (or unset) any of several 
options. When you enter vi, options are assigned certain default values, io se 
editor options as you want them, use the : set command. 

When exiting vi, all options return to the default, so you will need to reset 
your options each time you enter vi. See the next section for how to make your 
options permanent. 

To see all your default options, type: 

:set all 

By using the set command, you can change these defaults. The syntax of the 
set command is as follows: 

: set option ( Return ) 

where option is the name of the editor option you want to use (see Table 6-9 
for descriptions of some of these options). 

To unset (discontinue) an editor option, type no before the option: 

: set no option [ Return 1 

To show only the changes you have made to the default options, type 
: set 
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The editor options affect how vi works. For instance, when vou first enter vi 
you don t see fine numbers preceding the lines of text. However, you can ui 

the number option (abbreviated nu) to change this feature. Type either the full 
option name or its abbreviation nu: , P tBe ,ul1 

:set number 


or 


:set nu 


o“ 2 until you unset the number 

ption or exit vi. To unset the number option, type: 


:set nonumber 


or 


:set nonu 
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Table 6-9 describes some 
To determine the options 


options, their abbreviated names, and default values, 
most useful for your needs, you might open a practice 


file and experiment with editor options. 


Table 6-9. Editor Options 


Option 

Abbrev. 

Default 

Effect When Set 

all 

- 

- 

Lists all editor options on the screen. 

autoindent 

ai 

noai 

Begins each new line of text in the same 

column as the previous line (useful for 
programmers). 

ignorecase 

ic 

noic 

Causes vi to ignore uppercase and lowercase 

during searches. 

number 

nu 

nonu 

Number each line of text. 

readonly 


noreadonly 

Enables write-protection on the file you are 

editing. This ensures that you don’t 
accidentally change or destroy the file’s 
contents. 


6-34 Writing and Editing with the vi Screen Editor 


















Table 6-9. Editor Options (continued) 


Option 

Abbrev. 

Default 

__Effect When Set 

showmatch 

sm 

nosm 

Shows the opening parenthesis, brace, or 
bracket when you type the corresponding 
closing parenthesis, brace, or bracket. This 
option is useful when you are typing 
mathematical expressions or writing programs 
in a language that uses parentheses, braces, or 
brackets. 

showmode 


noshowmode 

Displays a message like “INPUT MODE” or 
REPLACE MODE” at the bottom of the screen 
whenever you are in either of these modes. 

wrapmargin 

wm 

wm=0 (zero) 

Changes the right margin, n equals the 
number of spaces in the right margin. For 
example, if you’re using an 80-column 
terminal, then : set wm=8 sets the right 
margin at column 72. 


th ® n ° n ;f fault settin § s en tered with this method will be lost each 
me you exit vi, the next section shows you how to make vi read your custom 
options automatically each time you open a file. 
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Making Your vi Environment Permanent 


To avoid setting options or defining abbreviations or macros each time you 
enter vi, place all options and definitions you normally use into an .exrc 
file (You can create this file, if it doesn’t already exist). The .exrc file is 
a file in your home directory that contains all your changes to vi system 
defaults. Your changes to the . exrc file makes your customized vi 
environment permanent^until you decide to change the file again. 


To change the default . exrc file, follow these steps: 

1. Type cd at the HP-UX prompt to ensure that you’re in your home 
directory; then use vi to create a . exrc file. 

$ cd 

$ vi .exrc 

2. Type the options, word abbreviations, and macros you want to make 
permanent (don’t precede the commands with a colon). 

3. Type :wq to save the text and exit vi. 

After creating the .exrc file, you can access it whenever you want to change 
your vi environment. Any of the editor options discussed in the previous 
section can be placed in this file for vi to read automatically each time you 

enter vi. 
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An Example of Changing Your .exrc File 

^t=rr ti0n ’^ ing ° Pti ° nS t0 ° hange Y ° Ur vi Environment,” you 

vi wraZS T ? ° Ptl ° nS Which WH1 Chan ® e the overa11 ^havior of 
in ile 69 yZ ^owmode are two of the useful options which were shown 
able 6-a You can also make vi recognize short forms of commonly used 
expressions by using ab to define an abbreviation. 

Suppose you include the following options and abbreviations into your . exrc 



Z 6 ! y ° U ’Z Ch ^f dyOUr Vi environmen t so that each time you enter vi you 
can expect the following: ^ 

■ The right margin automatically contains eight spaces (changing the default 
rom zero), and a carriage return will happen after approximately 72 spaces. 

■ The lower right part of the screen will show “INPUT MODE” when vou are 

in any of the text insert modes. y 

■ The abbreviation eecs will automatically expand into the words Electrical 
Engineering and Computer Sciences whenever you enter eecs. 

To chonge your . exrc again, use vi to edit as needed for your special needs, 
tte “anges™ Cha ” Smg ‘ he exrc file ’ the : w<j command to save 


For Additional Information 


To obtain more details about how to use the vi screen editor 
Guide to vi and vi in Section 1 of the HP-UX Reference. 


, see The Ultimate 
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Chapter Command Summary 


Table 6-10. 


To Do This ... 

Type This 

Enter vi 

iri filename 

Make sure you’re in command mode 

Press [esc) 

Insert text before the cursor position 

3 ress 0 

Insert text after the cursor position 

Press Q 

Find out what file you are in 

Press (ctrl>0 

Show whether you are in command or insert mode 

:set showmode 

Write (save) the current file. 

: w 

Write the current file to file-name 

:w file-name 

Overwrite the contents of file-name with the 

:w! file-name 

current file. 

Write lines x through y of the current file to 
file-name. 

:x,y w file-name where x,y 
represents specific line numbers 
or place markers. 

Copy a line into a buffer 

yy 

Put copied or deleted text line after cursor line 

P 

Read in another file after cursor line 

:r filename ( Return) 

Find text 

/ text 

Run an HP-UX command while in vi 

:! command-name 

Print the current file 

:!lp # /p 

Print a file 

: ! Ip filename 

Write the current file and quit (exit) vi. 

: wq 

Quit vi without saving any changes. 

: q! 

Join lines of text 

J at end of line 

Set line length (wrapmargin) 

:set wrapmargin=n 
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7 


Sending and Receiving Mail 


If you are on a multi-user system, you can send mail messages to other 
users on your system using the elm mailer. If your system is connected to a 
network, such as a local area network (LAN), you may also be able to send 
mail messages to users on other systems. 


This chapter will help you in doing the following basic tasks in elm: 

■ Reading your mail 

■ Sending mail to users on your system 

■ Sending mail to users on other systems 

■ Deleting mail messages 

■ Saving mail messages 

■ Customizing elm 

For further information on using elm and other mail systems in HP-UX see 

Mail Systems: Users Guide ’ 7 
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Getting Started with the Elm Mailer 

To start the elm mailer, enter 
$ elm 

A display similar to the following appears: 



Figure 7-1. 


You can enter an elm command in either of two ways: 

■ Type the first letter (uppercase or lowercase) of the command. 

■ Press the softkey that corresponds to the command. (You can execute the 
command menu choices, Head Msg , Mail Msg , etc. that appear at the 
bottom of the screen by pressing softkeys QT) through (¥) at the top of your 
keyboard.) 

The examples in this guide use the first method: typing the first letter of the 

command. 
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Leaving Elm 

^ m 6 n m ’ y ° U Can leaVe lt by typing the response to Command. If you 
have mail, elm will respond in the following way: 7 

Command, q Keep mail in incoming mailbox ? (y/n) y 

fo° r U yo“ r^r P °" d 7 '° the Pr ° mPt ° r ^ ® wWch ^ «"*<» a 7 

in ‘ he inC ° ming mailbox remain there - shell prompt 

mailbox called T Wer ° 40 th : prompt ' ,ncssa B es are stored in an alternate 
mailbox, called mbox, in your home directory. 

Setting Your Elm Environment: the .elm Directory 

Like many programs in HP-UX, elm will automatically refer to a 
/.elm/elmrc file for how to configure your version of elm. This will happen 
each time you start elm. If your home directory does not have the . elm ? 
directory with the elmrc file, you should create them: 

$ mkdir .elm 
$ cd .elm 
$ vi elmrc 

The elmrc file can contain different kinds of “customization” information. 

7 h ° W t0 S ° rt y ° Ur meSSage lists: in alphabetical 

order by the order in which they have come in, or in some other order. It 

can tell elm which type of editor you would like to use (if other than the one 
determined in your .profile). The section, “Customizing Elm,” will give you 
more details on how elm will set up your elmrc file for you. 

While you're in the , elm directory, you should also create a directory to 
store the names of users you commonly send mail to. These lists can then 
e identified and referred to by elm as one-word “aliases.” The use of aliases 
makes group mailings much simpler. 

For example, the following alias entry will enable you to mail to five different 
people with one name” (some include an address for other systems): 

call - anne, pat, michael, don@ulpcu3, paul@ulpcu3. 
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Reading Your Mail 


To read your mail, start the elm mailer. If you do have mail, elm displays a 
list of mail messages. You can read the current message or pick a specific 

message to read. 


To determine whether you have any mail, type: 

$ elm 

The elm screen appears. If you have messages, elm lists the message 
information in a display similar to the following: 


Mailbox is ’/usr/mail/leslie’ with 4 messages [Elm revision: 64.9] 


H m 

N 2 
N 3 
N 4 


Figure 7-2. 


Aug 9 James Keath 
Aug 9 James Keath 
Aug 9 Anne Rand 
Aug 9 travis_hall®07 


(14) Project Report 
(14) Congratulations! 
(159) Results of Meeting 
(91) Management Guide 


To read the current message (that is, the message highlighted in inverse video) 
press fi5j . (On some systems the current message may be indicated by a to 

the left of the message.) 


Caution 


Problems with system behavior may result if you attempt to 

use one of the other HP-UX mailers, such as mailx, while you 
are also working in elm. 
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The following example shows the output from reading message 1. 
Message 1/4 from James Keath 


Subj ect: Project Report 
To: leslie 

Date: Mon, 26 Nov 90 16:26:45 MDT 
Cc: 


The project report is in the mail. 
Hope you enjoy it! 

Best regards, 


Jim 

To return to the elm main screen, press (r^T). 

Moving Through the Header Information 

You can select a message to read as follows: 

■ Type j to advance to the next message, k to move to the previous one, just 
yl“ m ° Ve the CUrSOr Vi PreSS S3 to -ad the message which 

' 2ft.'G=r flC ^ in headCT ' "—«• 


Displaying Message Headers 


Only ten message headers appear on the screen at one time. If 
than ten messages you can display them as follows: 


you have more 


■ To see the next page of message headers, press + 

■ To see the previous page, press 

■ To move to the first message in the list, press =. 

■ To move to the last message in the list, press *. 
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Sending Mail to Users on Your System 

One of the easiest ways to learn how to send a mail message is to send one to 
yourself. If you’re not already in elm, enter: 

$ elm 

To mail a message, type the response to Command: 


Command: m 

elm responds with a prompt requesting the mail address of the recipient. 


Send the message to: leslie Enter your own user name. 

elm then responds with a subject line prompt: 

Subject of message: Type the subject line for the message. 

For the message we’re about to type, you might enter a subject line like: 

Subject of Message: Important Message to Myself 
After entering the subject line, press [Return), elm responds with a prompt 
the carbon copies: 


Copies To: Since you’re sending a message to yourself, 
you don’t want to send any additional copies 

SO press f Return ) ■ 


for 


On most systems, elm brings up the vi editor. (Some systems may be 
configured to bring up a different editor). 

If you’re in vi, press i to enter insert mode, and then begin typing the 
message. At the end of each line, press [Return). 

This is a mail message sent to myself. 

Does it work? 

We’ll soon see. 


Goodbye, 

Leslie 

To exit the vi editor and save your message, press © and then : 
: wq 
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For more information on the vi editor, see Chapter 6 in this manual. 

After yon exit the editor, you’ll see the following message on the screen. 

Please choose one of the following options by the first character- 
E)dit message, edit Readers, S)end it, or F)orget B * UX * ctn ' 

To mail your message, type: 


Til* 1 ? IT the elm main screen ™»PP««i ond displays 
It nught take a few minutes for the system to 

Sending a Message to Multiple Recipients 

^mpu“£ ie ‘„ 0 t mUltiPle US6rS ’ SPeC ‘ fy ^ USer ' 8 " ame «» - 

Send the message to: mike leslie tj 
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Sending Mail to Users on Other Systems 


If vour system is connected to other systems over a LAN (local area 
network), UUCP or other networking facility that supports elm, you 
send mail to users on other systems. 


can 


Node Names 

Every system connected over a network has a unique node name (also known 
as a host name). When sending mail to each other, systems must know each 
others’ node names. Figure 7-3 shows an example LAN with four systems 
connected. The node names are research, develop, market, and sell. 


recpnrrh 

market 

Series 800/850 


Series 500/540 

-1 


1 

Series 300/350 


_ 1 _ 

Vectra 


sell 


Figure 7-3. Example LAN and Node Names 


To determine your system’s node name, use the hostname command. 
$hostname 

market Your hostname is displayed. 
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Mail Syntax when Mailing to Other Systems 

The general syntax used when mailing to a user on another system is either: 

nodeluser UUCP format 

or 


user@node ARPA/Berkeley format 

In the above example, node is the node name of the system the person is on 
and user is the person’s unique user-name. Which syntax you use depends on 
whether your system uses UUCP or ARPA/Berkeley network services Your 

system admimStrat ° r wiH be able to tel1 y°« which syntax to use on your 


Some Example Mail Addresses 


Suppose you want to send mail to user John, who uses the system named sell 
addresses: 6SPOnSe ^ Pr ° mpt ’ y ° U W ° uld USe ° ne of the follow ing mail 


sell!john 
or 


john@sell 

k‘° T ie ° n y ° m T tem ' i0hn the sel1 system, and leopold on 
search system, use one of the following addresses: 


arnie sell!john research!leopold 


or 


arnie johnOsell leopoldOresearch 
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Deleting Mail Messages 

After you’ve read your mail messages, you may want to delete them. You 
can mark messages for deletion using the d command. When you execute 
either the $ command, or if you quit elm, you will delete the marked 
messages. 


Marking Messages to be Deleted 

To delete a mail message, press d while the message is the current message. A 
D appears to the left of the message to show that it is marked for deletion. 

You can mark additional messages for deletion by making each message the 
current message and then pressing D. Remember, to move to the next message, 
press j, to move to the previous message, press k. You can also use the arrow 

keys, ©> 

The following screen shows two messages marked for deletion. 


Mailbox is ’/usr/mail/leslie’ with 4 messages. [Elm revision: X.X] 


1 

Apr 3 

Leslie 

(6) 

Important Message to Myself 

2 

Apr 3 

Robert 

(24) 

Meeting Tommorrow 

3 

Apr 2 

Lynn 

(154) 

More Software Requests 

4 

Apr 2 

Patrick 

(78) 

Hi there 
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Delete the marked messages at the command: prompt in one of two ways- 
' messages quit elm - ento * -«* yo„ 

■ To delete the marked messages without quitting elm, type $. 

madl^ox orTave^hem to a te. ^ ^ ^ m6SSageS in a different 
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Saving a Mail Message to a File 

When you quit elm you have the option of keeping your messages in the 
incoming mailbox (where your new messages arrive), or storing them m 
another mailbox (the default is homedirectory/m\>ox). While m elm you (an 
also save messages to a designated file. 

To save the current message to a file, at the elm command prompt, type: 
Command: s 

The following prompt appears; 

Command: Save Message 
File message in: =/username 

If you press &T) , the message is saved in a file named with the sender’s 
username inTh^ail directory in your home directory. The default mail 
option is set so that the equal sign (=) is shorthand for homedirectory/ 
the Mail directory doesn’t already exist, you need to create it. 

If you want to save the message in another file, enter the name of the file. For 
example: 

Command: Save Message 
File message in:=/oldnews 

Supposing that Leslie is the user, the current message is saved in the fiie 
oldnews in the /user/leslie/Mail directory. If the file already exists the 
message will be appended to the contents of the file. If there is no existing 
oldnews file, one will be created. 

After you save a message in a file, the message is marked with a D for deletion. 
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Two Ways to View Saved Messages 

" Jrlw m ° St f C v° mm0n Way t0 view saved messages is to change your mailbox 
and view them as you do in the incoming mailbox. 

S' that y ° U have saved in the file oldnews two messages 

Requ T and “ Meetins t< ~-” ^2? 

messages m the oldnews mailbox, use the change mailbox command: 
Command: c 

One or more prompts appear asking you whether you want to keep mail in 
your incoming mailbox or delete it. Answer y or n as you choose 

Then elm prompts you for the name of another mailbox. After the “=” 
(which stands for ‘homedtrectory/Mail”) enter the name of the file, oldnews: 

Name of new mailbox :=/oldnews 
The mailbox changes to =/oldnews. 


Mailbox is ’-/oldnews’ with 2 messages. [Elm revision: X.X] 

1 Apr 3 Robert (24) Meeting Tommorrow 

2 Apr 2 Lynn ( 154 ) More Software Requests 


t mn^rT View messages saved in a file is to use a shell command such 
wi : f ^ m elm and want to ac cess a shell command like more 
without leaving elm, enter “!” at the Command: prompt. For example to 
examine the contents of the oldnews file: example, to 

Command: ! 


Shell Command: more /users/leslie/Mail/oldnews 
Press (Return) to return to elm. 
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Customizing Elm 


The elm mailer has different options you can set to make it more 
convenient for you to use. Among features you can change ar<i the menus 
that appear on the screen, the printer your mail is sent to, and the order in 
which your mail is listed in your mailbox. These are entered automatically 
in the elm/elmrc file which you set up previously in your home directory. 


Bringing Up the Option Menu 

To bring up the option menu, press o at the elm command prompt: 
Command: o 

You’ll see a menu similar to the following: 


r - 

C)alendar file 

___\ 

/users/leslie/calendar 

D)isplay mail using 

builtin 

E)ditor 

/usr/bin/vi 

F)older directory 

/users/leslie/Mail 

S)orting Criteria 

Date Mail Sent 

0 )utbound mail saved 

/users/leslie/mbox 

P)rint mail using 

pr %s 1 lp 

Y)our full name 

Leslie Pendergrast 

A)rrow cursor 

: OFF 

M)enu display 

: ON 

U)ser level 

: 0 (for beginning user) 

N)ames only 

: OFF 

Dabs to spaces 

: OFF 

Select first letter of 

Option line, ’>’ to Save, or R)eturn 

Command: 



Figure 7-4. The Options Menu 
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This guide does not describe all of the options in the option menu. Rather it 

g ves you an example of changing an option; in this instance how to change the 
order in which your mail is listed. g 

Changing the Order of Your Mail Messages 

P^rtThffirsTftV” W r h i? y °“ r maU meSSaBeS Hsted in y° ur 

P ss s (the first letter of S)orting criteria) in the alias menu. 

Command: s 

example 66 & meSSage indicating how messages are currently sorted. For 

This sort will order most-recently-sent to least-recently-sent 

Ch ° iCeS f ° r S ? rtingy0Ur messages, press (1^7). When you see 
the method you want, press (jwT) , V -' y u see 

For instance, when you see: 

This sort will order by sender name 

Press (Return), then press > to save the change. 

The change is entered in the elmrc file in the . elm directory that you have set 
up previously in your home directory. 

To return to your mailbox, press (r^TT) again. 

The messages in your mailbox will now appear in alphabetical order by sender 

option in the option menu ' type ? then 

For More Information ... 

For more information on the options command and the elmrc file see Mail 
Systems: User s Guide and the e/m(l) entry in the HP-UX Reference. 
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Chapter Command Summary 

Use the following commands from the Options Menu. Other commands are 
available from the Alias Menu. 


Table 7-1. 


To do this ... 

Use this elm 
command ... 

Delete the messages marked for deletion without quitting elm. 

(“Resync”) 

$ 

Get help on elm commands. 

? 

Allows you to send a command to the shell without leaving elm. 

I 

Set up mail aliases. 

a 

Change the mailbox. 

c 

Mark messages for deletion. 

d 

Forward the current message to another user. 

f 

Send a group reply to all recipients of the original message. 

g 

Move the message pointer to the next message (below). 

j 

Move the^message pointer to the previous message (above). 

k 

Send mail to a specified user or users. 

m 

Allows you to alter the setting of different mail parameters, 
including the sorting method for messages, the destination of 
orinted messages, the type of menus displayed, and so on. 

0 
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Table 7-1. (continued) 


To do this ... 

Use this elm 
command .. 

Print messages. (You can change the destination of printed 

messages using the o command listed above.) 

P 

Quit elm with the option of changing the contents of the 
mailbox. 

q 

Reply to the author of the current message. 

r 

Save a message to a file. 

Exit elm without making any changes. 

s 

X 


To see a summary of all of the commands you can use from elm, type at 
the elm command prompt. yp ' 

tteto? letw V F tC CTer) ' 7“ COmmand (““P 1 h «lP) merely by specifying 

stade d T„ „hh TT P e ’ y °“ C “ abbrevia * e *e command with a 

gle d. To abbreviate help, use a question mark (?). 
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For More Information . 

For more information on the elm commands see the following entries 
1 of the HP-UX Reference : 

elm 

readmail 

newmail 

elmalias 
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Searching and Sorting 


s^chandfilp 4116 V C ,7 mand for use within there are many valuable 
search and file-manipulation tools in HP-UX that work from a shell. 

Specifically this chapter discusses: 


■ Searching for files using find. 

■ Searching for text patterns using grep. 

■ Sorting files using sort. 


™° re ‘ nformation on “y of commands discussed in this chapter, see the 
e " tneS f ° r fl ” d - ■«. oc refer to the approve 
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Searching for Files using find 

You can use the find command to search through a directory and its 
subdirectories for files meeting certain criteria. You can then execu 
command on the files you’ve found. To display the output of find on 
screen, you must use the -print option. 


Finding Files that Match a Pattern 

Although the syntax of find can be complex, it may help you in using HP-UX 
in a more productive way, simply by applying the following examples. 

Suppose you want to display all files in the current directory and its 
subdirectories that begin with d. Enter: 

$ find . -name ’d*’ -print 

The dot ( ) causes find to search the current directory and its subdirectories 
The -name option followed by a filename or a filename pattern (in this case*) 
tells find to search for all filenames that match that pattern. In this example, 
find will look for all file names beginning with d. 

Note that: 

■ d* is enclosed by single quotes’d*’. If you use a file name pattern in the 
nnd command, you must quote it so that the shell will interpret ,t correctly. 
The -print option displays the output on the screen. 

■ The order of -name ’d*’ and -print is important. If -print were first, find 
would print all names. 


Finding Files that are Newer than a Certain File 

Suppose you want to display all files modified after a certain file. To display all 
files newer than myf il. in the /users/leslie directory and its subdirectories, 


enter: 

$ find /users/leslie -newer myfile -print 


This example can 
its subdirectories 


be read as follows: find in directory /users/leslie and 
all files modified after myfile and display the output on 
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commlnd 1 ) ^ ^ ° Ut ^ datG time & file WaS last modified > use the 11 


Running Commands on Files 

You can execute commands on files located with the find command T ot >c 

" tmP eXtenSi ° n ^ the CUrrent director ^ a " d 

$ find . -name ’*.tmp’ -print -exec rm {} \; 

This example finds and displays on the screen all files in the current directory 
and its subdirectories that end in .tmp, then deletes these files The exec 
option causes the following command (rm) to be executed. The brackets { 1 
represent the files found with the find command. The semi-colon that enVs 
the command string is escaped with a backslash (\;). 
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Searching for Text Patterns Using grep 

You can use the grep command to search for a text pattern within a file or 
to display the names of files that contain a specified text pattern lhis 
command is useful when you want to search for information in files or 
directories. 


Overview of the grep Command 

The grep command (“global regular expression print”) looks at each line of 
one or more files for a text string that matches a specified pattern. When it 
finds a matching text string, it displays the line in which the matching string 

found. 

Searching a File for a Text String 

Suppose you have a mailing list called mailist with the contents shown below: 


Smith, Joe 
Walsen, Stacy 
Diaz, Robert 
Wang, Michael 


2345 Pine St. Santa Clara, CA 
493 Winkle Ave. San Jose, CA 
6789 Pine St. Santa Clara, CA 
1832 Jackson St. Santa Clara, CA 


If you want to extract the addresses of all the people on Pme St. Enter: 

$ grep Pine mailist 

The grep command lists all lines in mailist that contain the string Pine. The 
output is: 


Smith, Joe 
Diaz, Robert 


2345 Pine St. 
6789 Pine St. 


Santa Clara, CA 
Santa Clara, CA 
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Searching Multiple Files 


The grep command can be useful in other ways. Sometimes you want to find 
in ormation, but you don’t know or can’t remember in which file it’s located. 

Suppose you have three mailing lists, and can’t remember which contains 
Stacey Walsen’s address, enter: domains 

$ grep >Walsen, Stacey’ mailist mailist2 mailist3 
mailist: Walsen, Stacy 493 Winkle Ave. San Jose, CA 

The grep command displays the line containing Stacey’s address and the file 
m which it was found. Note that because it contains a space, tTe "ring must 
be surrounded by single quotes (’Stacey, Walsen’). If grep had found other 
instances of the specified text string, it would list each instance that it found. 

lTd staTenter" 11 ‘ he direCt0ry f ° r * his taxation, you 

$ grep ’Walsen, Stacey’ * 
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Ordering Files Using sort 

You can use the sort command to order the contents of files, sorting 
alphabetically, numerically, or by different fields. 


Overview 

The sort command displays sorted file contents on a line-by-line basis. It 
compares the first characters in each line; if they are the same, it compares the 
next two characters, and so on through the end of each line. 

The sort command also recognizes different sortable fields. Fields are 
separated from each other by spaces or tabs. If there is more than one leading 
space before a field, sort will count each space as a sortable character. 


Displaying Sorted File Contents in Alphabetical Order 

Here is an example file called list, containing the names and telephones 
numbers of the members of a tennis club and the number of tickets they have 
sold for a benefit match. Each line in the file has four fields: the first name 
the last name, the number of tickets sold, and the phone number. The field 
are separated by spaces. 


If you want to practice using the sort command, type in the list file using 
the cat command as shown in the following list: 


$ cat > list 

Nancy Smith 4 467-2345 

Jeff Bettleman 8 438-7689 

Jeff Plimpton 13 729-8965 

Joyce Smith 6 245-1342 

To display the sorted contents of the file, enter: 

$ sort list 

Jeff Bettleman 8 438-7689 

Jeff Plimpton 13 729-8965 

Joyce Smith 6 245-1342 

Nancy Smith 4 467-2345 
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Note that the list is sorted alphabetically by first names, 
without any options will sort starting with the first field 
example the first name). 


The sort command 
in each line (in this 


The sort command places the two “Jeffs” in the correct 
comparing the first names and finding them identical, it 
helds (last names). 


order, because after 
compares the second 


Sorting Files by Different Fields 

The next example shows how you can use sort to order the list by last names. 
$ sort +1 list 

Jeff Bettleman 8 438-7689 

Jeff Plimpton 13 729-8965 

Nancy Smith 4 467-2345 

Joyce Smith 6 245-1342 

‘° Skip the flrst fleld of each line and start sorting 
at the second field (the last names). However, note that the first names Nani 
and Joyce are not in alphabetical order. y 

The next example shows how to sort by last name and then by first name. 

$ sort +1 -2 +0 list 

Jeff Bettleman 8 438-7689 

Jeff Plimpton 13 729-8965 

Joyce Smith 6 245-1342 

Nancy Smith 4 467-2345 

Jew rL?n SeS T the first field (first name ) and sort by the second 

field (last name). The -2 causes the sort command to stop after comparing 

SmithTf/ 6 n S; l l ^ ° f the SeC ° nd fidds are identical ( in this case the 
Smiths), the +0 instructs sort to make a second pass and sort from the 

beginning of the line (putting the first names in correct order). 

Note that the sort command will only make a second pass at comparing lines 
if its first pass shows all of the examined fields in the lines to be identical If 
2 were not specified in the above example, sort would show the third fields 

htTrst nlmeJ ^ ^ WOUld never make a Second P ass to ™mpare 
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Sorting in Numerical Order 

Suppose you want to sort the file by the number of tickets sold. Enter: 


$ sort -rnb +2 -3 list 
Jeff Plimpton 13 729-8965 

Jeff Bettleman 8 438-7689 

Joyce Smith 6 245-1342 

Nancy Smith 4 467-2345 

There are several things to keep in mind when sorting in numerical order 
First sort will consider multiple leading blanks in its comparison. Since there 
are a variable numbers of blanks preceding the third field (ticket number), your 
results will be incorrect unless you use the -b (ignore leading blanks) option. 


Also, the numbers will not be in the right order unless you use the -n 
(numeric) and -r (reverse) options. The sort command by default sorts from 
least to greatest numbers so you need the -r option to list the greatest num er 
first Also, by default sort works by comparing characters in a held in the 
order they appear. So without the -n option, 8 would come before 13, because 

8 is larger than 1. 
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Table 8-1. General Commands 


_ To do this ... _ 

Sort the contents of a file and display the results 

to SmnHarrl 


to standard output 

Find all filenames in the current directory and 
subdirectories beginning with “x” 

Find the word “Jim” in any file in the current 
directory 

Find the words “Joe Smith” in any file in the 

r*nrronf - 


sort options filename 
find . -name *x** -print 
grep Jim * 
grep ’Joe Smith* * 



Table 8-2. Common sort Options 

sort 

option ... 

Does this ... 

-b 

(disregard leading blanks) Blanks, which can be either spaces or 
tabs delimit sortable fields. Without the -b option, sort considers 
all blanks preceding a field to be part of that field, and will use 
them in sort comparisons. 

-d 

(dictionary) disregards all characters that are not alphanumeric or 
pumtuatfon^ 1011 ar ’ ^ ° Pti ° n disregards control characters or 

-f 

(fold) doesn’t consider any difference between upper and lower case. 

-n 

(numerical) sorts in numerical order. Plus and minus signs are 
dedmCint, ^ '***' ““ d °‘ S < > *" - 

-r 

(reverse) reverses sort order (i.e., z-a). 

-u 

(unique) removes duplicate lines from a sorted file. 
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Using Your Shell Environment 


HP -UX gives you your choice of several different shell-types which you can 

K ° rn ’ and ^ ShdlS - Infon ™ti°n 

n the C Shell can be found in the Appendix. Each of these shells has 
different characteristics, and you can increase the speed and efficiency with 
Which y° U mtcract with HP-UX if you learn to use some of thfbXin 
features of the shell of your choice. 

"f “ e , K ^ SM ' i " d ““ Ke * SM >. >">“ ™ your command line 
and recall, and re-enter, previous commands. Your shell environment can 

be customized using shell variables and login scripts. One of the 

ZmaSsTd file"" 151 " ^ ^ t0 ^ ^ direCt0ries for 

IrthtThelfy^'' 1 ' 5 y ° U h ° W y0U temp0rari1 ^ or invoke 


This chapter covers these topics: 

■ Shell features: determining and changing your shell. 

■ Editing your command line. 

■ Recalling previous commands. 

■ Setting the login environment. 

■ Using login scripts to set the system environment. 

■ Setting and referencing variables. 

■ Finding commands with search paths. 

■ Setting terminal characteristics. 
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Using simple commands, you can determine which shell you arc rung, 
temporarily change your shell, or permanently change your shell. TaW - 
compares the features of the Bourne, Korn, Key and C Shells. (The t 
Shell is discussed in detail in the Appendix.) Refer to Table 3-1 for 
listing of both the file name for each shell and the default system promp . 

Below are listed some of the features which may help you make a decision on 
which shell would be best for the kind of work you are doing: 



Features 

Description 

Bourne 

Korn 

Key 

C 

Command 

history 

A feature allowing commands to be 
stored in a buffer, then modified and 
reused. 

No 

Yes 

Yes 

Line 

editing 

The ability to modify the current or 
previous command lines with a text 
editor. 

No 

Yes 

No 

File name 
completion 

The ability to automatically finish 
typing file names in command lines. 

No 

Yes 

Yes 

alias 

command 

A feature allowing users to rename 
commands, automatically include 
command options, or abbreviate long 
command lines. 

No 

Yes 

Yes 

Restricted 

shells 

A security feature providing a controlled 
environment with limited capabilities. 

Yes 

Yes 

No 

Job 

control 

Tools for tracking and accessing 
processes that run in the background. 

See Shells: User’s Guide 

No 

Yes 

Yes 
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Determining Your Login Shell 


A /i°\ f T d m Chapter 1, the command echo $SHELL 
ot the shell you entered when you logged in. 


displays the file name 


$ echo $SHELL 
/bin/sh 
$ 


Thf ^p,°, CO ”"";T l diSplayS the contents or value of a variable named SHELL 
The SHELL var.able contain, the name of the file that contains the shell 

” r,he u Bo"t"r In lhis case ii is /bin/sh ’ the fi,e that «“•*» 


Table 9-2 lists both the file 
system prompt. 


name that displays for each shell and the default 


Table 9-2. Shell File Names and Default Prompts 


Shell 


File Name 


Prompt 


Bourne 

Korn 

Key 

C (See Appendix) 
Restricted Bourne 
Restricted Korn 


/bin/sh 
/bin/ksh 
/usr/bin/keysh 
/bin/csh 
/bin/rsh 
/bin/rksh 


$ 

$ 

$ 

% 

$ 

$ 
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Temporarily Changing Your Shell 

Unless you are in a restricted shell, you can temporarily change your shell by 
using this command: 


shell-name 

where shelLname is the name of the shell (for example, sh, or ksh). 
Temporarily changing your shell lets you experiment m other- shell s. By typr g 
the name of the shell you want to run, you invoke (enter) 
correct prompt is displayed. After experimenting in the new shell, return to 
your original shell by typing either exit or (ctrlHd). 

The following example begins in the Bourne Shell, enters the Korn Shell, and 
returns to the Bourne Shell: 


$ ksh 


$ ps 


PID TTY 

TIME COMMAND 

6009 ttyOl 

0:00 ksh 

5784 ttyOl 

0:00 sh 

6010 ttyOl 

0:00 ps 

$ exit 



$ 


Enter Korn Shell. 

Execute the ps command. 

Notice that both the Korn Shell and 
Bourne Shell processes are running. 

Exit Korn Shell. 

Bourne Shell returns. 
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Permanently Changing Your Shell 


in') P® rmanen * ly chan g e your login shell (the default shell you get when you loe 
in), use the chsh change shell) command: y g 

chsh username fulLshelLname 

Sr' h S |T name a “ d ske l L patk-name is the full path name 
l - g ., /bin/ksh) of the shell you want as your default. After you use the chsh 

For n examnle°if t H1St IOS h° Ut “I, 108 “ again f ° r the change to take effect. 
commaTd «^s y ^ ‘ he defaU '* '° gin sM1 the K °™ Shell, the 

$ chsh terry /bin/ksh 

$ 
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Editing Your Command Line 

In the Korn Shell and the Key Shell, you can correct errors and make 
changes in the command line you are entering. You can make these 
changes with the line-editing commands or edit keys. 

It can be very frustrating to type in a long command line only to discover that 
there is an error in the Bret part of the line. In the Korn Shell, and in the y 
Shell you can correct such errors by using the line-editing commands, 
built-in line editor allows you to move the cursor to the point in the line where 
you wish to make a change. There you can enter the correction ex ““‘ e 
[he command. If you type in a line containing an error “"d ^ute^t « Jso 
possible to recall that command, edit it and execute it again. (See Reca g 
Previous Commands,” later in this chapter.) 

Using a Line-Editing Command Set 

In Chapter 6 in this manual, you learned how to use vi screen editor with text 
files. The vi editor is also used to edit command lines. 

To enter the vi line-editor mode while in the Korn or Key Shell, press dD to 
change from the usual “typing mode” into “edit mode.” to move the cursor to 
a new location or to delete characters. You then change back to tyP'ng mode 
by entering the vi commands i or a to insert or append text In Key Shell, 
you can also use the arrow and editing keys on your termina . 

Note that you can use the line-editing features only in the Korn Shell and the 
Key Shell. If you are in another shell, change to Korn Shell before proceeding 

further. 

$ /bin/ksh 

Table 9-3 contains a partial list of the editing commands available. 
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Table 9-3. vi Line-editing Commands in Korn Shell 


Desired action 

vi 

command 

Move back one character 

h 

Move forward one character 

1 

Move back one word 

b 

Move forward one word 

w 

Move to the beginning of the line 


Move to the end of the line 

$ 

Delete the character under the cursor 

X 


I 1 ! 6 command set you will use is governed by the setting of the EDITOR 

variable. Some possibilities are vi or emacs Setting- the PDTTOR • ui 
depends on tho vtqttat • , . , oeinng tne LD1 1 OR variable a so 

depends on the VISUAL variable being defined. If you decide to use the vi 

editor on a temporary basis, set it in this way: 

$ set -o vi “set minus letter-o vi” 

$ _ 

To turn off the vi editing mode, type: 
set +o vi 

To set the EDITOR variable automatically each time you log in see Chapter 
II, Customizing Login Scripts," in this manual. 6 Chapter 

Executing vi Line-Editing Commands 

To execute the vi editor commands, press (esT) (to enter the command mode) 

Dress H U V1 C °T mandS f ° r the desired actions - To return to “typing mode ” ’ 

, Q[ t0 insert text at the current position of the cursor) or (TUto append 
text at the point immediately to the right of the cursor). ^ PP 
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An Example of Line Editing with the vi Command Set 

Activate the vi command set (if it is not already activated at login by your 
login script): 

$ set -o vi 

$ _ 

Type this line without pressing f Return] : 

$ 11 /dve I grep ’~d’ I more_ 

The second element should have been /dev. Correct the error by following 
these steps: 

1 p ress (|sc). The cursor moves back one space (beneath the e in more). The 
line editor is now in “command mode.” 

$ 11 /dve I grep ’~d’ I more 

2. Press © repeatedly to move the cursor to the beginning of the line. 

$ 11 /dve I grep ’~d’ I more 

3. Press © five times. The cursor moves beneath the v in /dve. 

$ 11 /dve I grep ’~d’ I more 

4. Press ©. The character v disappears, and the rest of the line shifts one 
space to the left to fill in. The cursor is now under the e in /de. 

$ 11 /de I grep ’~d’ I more 

5. Press Q. The cursor moves one space to the right. The line editor is now 
ready to “append” text to the line. 

$ 11 /de_l grep ’~d’ I more 

6. Press Q. The character v is inserted after /de, completing the correction. 

$ 11 /dev I grep ’~d’ I more 

7. Press fReturn) to execute the command line. 
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For More Information ... 

s; r—■ “ *• “ 
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Recalling Previous Commands 

The Korn and Key Shells store the commands you execute in a command 
history. You can retrieve these commands, modify them, and re-execute 

them. 

The Korn Shell and the Key Shell have a built-in “memory” of the command 
lines you type in. These commands are stored in a special area called the 
command htetory. For information on the C Shell implementation of command 
history, see the Appendix of this manual. 


The Korn Shell’s Command History 

First make sure you are in the Korn Shell. If you are not, type the following: 


$ /bin/ksh 

$ 


The cursor will remain the same, although the shell has 
changed. 


Execute some commands, as a test. Then, to re-execute a previous command: 

■ Make sure you have set vi as the command line editor (enter set -o vi on 
the command line for the login session, or make the the appropriate entries 
in your .profile to set and export the EDITOR variable.) 


■ Press (esc). 

. Then press Q repeatedly to scroll “up” to the previous command that you 
want. 

. Or press Q to scroll back “down” through the command history list. 

■ Once you have found the command you want, you can edit it just as if it 
were the current command. 

. You can then execute whatever is on the command line by pressing ® • 

The Korn Shell “remembers” the last 128 command lines you typed in and can 
display all or any of them. For example, type in some commands: 


$ date 

Wed Mar 29 10:57:28 MST 1989 
$ pwd 
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/users/terry 
$ hostname 
hpfcma 

$ _ 

Now type in this command: 
$ history -3 


121 

122 

123 

124 
$ 


date 

pwd 

hostname 
history -3 


of the command history shown by using a larger negative number to Mow” 4 

—ds r„\ e heTis! e o'ry hiS diSP ‘ ay * he ^ 100 C “ » «« are .00 

$ history -100 

Lt;:* bells" C ° mmandS in the ^ the m <* U» 

the command history and edit commands ifwith K-n J , th 1 rou » h 

displayed the command line you want, you can^u^Tt by^/glT 

For More Information 
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Setting the Login Environment 

When you log in, your shell automatically defines a working environment 
for you that l uniquely identified from every other env.ronment on he 
system. Your environment defines such characteristics as who you are 
where you are working, and what processes you are running, our s e 
ZTtL this environment until you log out. The characterisei of your 
environment are defined by values assigned to environment variables. 

Your shell environment is analogous to an office environment In the office, 
physical characteristics like lighting and temperature are similar f °r everyone. 
But many factors in your office environment are unique o you, sue y 
routine tasks and your individual workspace. Thus, your work env ^onmen 
is different from that of your co-workers-just as your shell environment 

different from theirs. 


The login Program 

When you log in, HP-UX runs a program named login. This program starts 
your session using data stored in the /etc/passwd file, which contains one line 
for each system user. This file includes your user name, password (in encrypt 
folXhome directory, and the shell to run when you log m If /ete/pass»d 
doesn’t specify a shell, the Bourne Shell (/bin/sh) is selected. 

The login program executes when you type your user name at the prompt 
(login:). Its tasks include the following: 

■ Display the Password: prompt (if you have a password). 

■ Verify your user name and password in the /etc/passwd hie. 

. Assign default or user-defined values to the shell environment. 

■ Start executing the shell process. 

Environment Variables 

The shell environment defines how HP-UX interacts with you. The 
environment’s characteristics are defined by environment variables which 
consist of a name and a value. For example, the directory in which you begm 
each session is your home directory; its environment variable is the variable 
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set *■** * he “>- 


Table 9-4. Environment Variables Set During the Login Process 


Variable 


LOGNAME 

MAIL 

PATH 

I SHELL 

[TERM 
|TZ 


Description 

Defines the user’s" home directory; the default 
directory for the cd command (for example 
/users/terry). 

Contains the user name (for example, terry). 

Determines where the system looks for mail. Set 
I based on the user name (for example, 
/usr/mail/terry). 

Sets the directories through which the system 
searches to find and execute commands. 

Determines which shell to run. Set to the last 
field in the /etc/passwd file entry for the user 

logging in. If this field is not defined, the default 
value is used. 

Specifies the kind of terminal for which output is 
prepared. 

Provides the current time zone and difference 
from Greenwich Mean Time. Set to Mountain 
Standard Time by default; your system 
administrator should change the value if you are 
in another time zone. Set by the script 
I/etc/profile. 


Typical Default 
Value 

Assigned during login 


username 

| /usr/mail /username 


/bin:/usr/bin: 

/usr/contrib/bin: 
/usr/local/bin 

/bin/sh 


hp 


MST7MDT 
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During the login process, HP-UX prompts you for you.- user name and 
password (if applicable) before displaying a shell prompt HP-UX als 
notes which shell you’ve selected to run, starts your shell process, and sets 
up your environment referring to login scripts. A login script is a file that 
lets you customize your environment. 

A login script is a file containing commands that let you define your system 
environment- When you log in, default values are assigned to environment 
variables Login scripts provide an automatic way to change the value of 
these variables ever/time you begin a session. If login scripts exist, they are 
executed by your shell before you get a shell prompt. 

Two types of login scripts are used: 

. A system script for all users of a particular shell on your system or HP-UX 
cluster. 

■ Local login scripts in your own home directory. 

Typically a system administrator maintains the system login scripts. (If there 

is no one in your group responsible for these 

of HP 9000 Computers and to System Administration Ta ). 

up a default environment for everyone on that system. The Bourne Shell and 

Korn Shell use a system login script named /etc/profile. 

You maintain the local login scripts in your home di ^' 
allow you to set up an environment specific to your needs. The Bourne 
Shefi looks for one script: .profile. The Korn Shell uses two login scripts, 
.profile and the one referred to by the ENV variable (by convention, it is 

called .kshrc). 


Why Use Login Scripts? 

Login scripts provide a convenient way to set up the shell environment to suit 
individual needs. For example, the script can change the value of the searc 
path used to find commands, change the shell prompt, set the terminal type, or 
simply cause the shell to greet you with a friendly message of your choosing. 
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mmssm 

your own login scripts. P ’ P ° f how to customizing 

A Summary of Login Scripts 

variable may refer to other scripts. 1 and thls 

A subshell is an entirely new shell that your current shell creates to run a 

For example ’ typing ksh at any she11 ^ 


Table 9-5. System and Local Login Scripts 


Shell 

Program Name 

System 

Login Script 

Local 

Login Script 

Bourne 

/bin/sh 

/etc/profile 

$H0ME/.profile 

Korn 

/bin/ksh 

/etc/profile 

$H0ME/.profile 
$ENV 

Key 

/usr/bin/keysh 

/etc/profile 

$H0ME/.profile 
$ENV 
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Your shell uses both environment variables and shell "S le8 ld passes 
your environment. Your login shell uses environment var ables and pas 
them to all processes and subshells that you create Shell variables are 
known only to your current shell and are not passed to subshells. 

The Bourne Shell and Korn Shell set variables using an assignment 
statement and an optional export command In all 

value of a variable by placing a dollar sign ($) in front of the variable n • 


To use variables, you will find out how to: 

■ set (assign a value to) a variable. 

■ reference (refer to) the variable s value. 


Assigning Values to Variables 

In the Bourne, Korn, and Key Shells, variables are assigned (or set). They 
can also be created, if necessary. Both tasks are done with an assignmen 

statement: 


name=value 

The name is the variable name and value is the value assigned to the variable. 
No spaces are allowed between name and = or between - and value. 

In the following example, which works with Bourne or Korn 
nrompt (PSl) is reset so that it reads: “Ready ==> . If PS1 is a shell variable 
the subshell (created by typing sh) does not know the new va ue. you ex 
PSl, the value of PSl passes to the subshell. 


$ PSl="Ready ==> " 
Ready ==> sh 
$ exit 

Ready ==> export PSl 
Ready ==> sh 
Ready ==> 


Set shell variable PSl. 

Enter subshell. 

Subshell has default prompt; exit returns to 
original shell. 

Set environment variable with export. 

Enter subshell. 

Subshell knows the new value of PSl. 
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Referencing the Values of Variables (Parameter Substitution) 

A i! Ihree shells use parameter substitution for referencing the value of 


Earlier in this guide, you learned 
command echo $SHELL: 


to determine your login shell with the 


$ echo SHELL 
SHELL 

$ echo $SHELL 
/bin/sh 
$ 


Because $ is omitted, the word SHELL is echoed. 
The $ is included, so the value of SHELL is echoed. 


The echo $SHELL command uses parameter substitution. The shell substitutes 

. V& U th° f j h n eimronm f nt variable named SHELL into the echo command 
because the dollar sign ($) precedes the variable name. 


For More Information ... 

the 1 HP f/Tffcf ' 3Ut p , ara “ eter substitution, refer to ksh, keysk, or csh in 
X Reference (section 1) or to the Shells: User’s Guide 
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Finding Commands with Search Paths 


When you type a command, HP-UX must be able to find the dtatory 
containing the command before it can run the comman . 
environment variable contains a list of directories you want HP-UXto 
search when looking for commands. Your PATH should contain all the 
directories necessary to locate all the commands that you use. If necessary, 
PATH can be customized, so that non-standard directories are searc e 


PATH Variable Format 

The PATH variable is read from your .profile or /etc/profile login script. 

If vou look at PATH in one of these files, you will see that it contains a is 
of directories to search, separated by colons. There should be no spaces 
surrounding the colons. 

You can also use the echo command to determine the current value of PATH, as 
follows: 

$ echo $PATH 
/bin:/usr/bin 

This line means that when you type a command, the shell first searches for 
the command in the /bin directory, then in the /usr/bin directory. If the 
command isn’t found in either directory, the shell displays this message. 

command-name : Command not found. 

To determine the current value of your PATH variable, use the echo command 
as shown above. For example, suppose you run echo and get a response as 

follows: 

$ echo $PATH ... 

/bin:/usr/bin:/usr/contrib/bin:/usr/local/bin 

In this example, the shell searches through /bin, /usr/bin 

/usr/contrib/bin, and /usr/local/bin— m that order—to find commands^ 
The shell will execute the first instance of the command that it finds along this 

path. 
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Changing PATH 

If the shell can’t find a command that you know exists, you have two options: 
You can type the full path name of the command. For example if you 

^er^:;— r ied Pr ° 6, and * reSideS in the direct ° ry 

/users/leslie/bin/prog 

2. However you can also change the value of the PATH variable to add the 
command path, /usr/contrib/bin. This may offer a better long-term 
solution if you use the command frequently. 

Table 9-6 shows the path names of the most frequently used directories You 
might want to add some (or all) of these directories to your PAm 

Table 9-6. Possible Directories to Include in PATH 


Directory 

What It Contains 

/bin 

/etc 

/usr/bin 

/usr/contrib/bin 

/usr/local/bin 

$H0ME/bin 

Frequently used HP-UX commands. 

Commands the system administrator uses. 

Additional HP-UX commands. 

Contributed programs not supported by Hewlett-Packard. 

Programs and commands written locally (at your location). 

A diiectory you might create for your shell scripts and 
programs. 


Because of the potential security risk, you would not usually 
pu your current directory (represented as . or the equivalent) 
as the Brst element in PATH. Leave the current directory out of 
your PATH, or include it only as the last element. 
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d m u that rlirectories in PATH are searched in the order in which they 
ap^r (left to right). In general, put the most frequently used directories first 
hi thepath—unless L commands in the search path have the same name (for 

example, /bin/rm and $HOME/bin/rm). In this example if you wa^ the she 

to find your version of rm first, put $H0ME/bin before /bin in PATH. 

The following example shows how to alter PATH to include $H0ME/bin before 
“Rectories, and to indude the current direct™, «“o" 
in the search path (this example assumes you re using the Bourne, Kor , 

Key Shell): 


$ echo $PATH 

/bin:/usr/bin:/usr/contrib/bin:/usr/local/bin 


$ PATH=$HOME/bin:$PATH:. 
$ echo $PATH 


Including . as the last element makes 
the current directory the last one searched. 


/users/terry/bin: /bin: /usr/bin: /usr/contrib/bin: /usr/local/bin: . 

$ 
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Setting PATH as an Environment Variable 

Normally, you set PATH as a environment variable, so it is set to the 

elESi U t e hp When lo e in - In * he Bourne and Korn Shells, you can 
change PATH in the .profile script and export it. You will learn more about 
these scripts in Chapter 10, “Customising Login Scripts,” in this manual. 
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Chapter Command Summary 


Table 9-8. Commands 


To Do This .. . 

Type This ... 

Determine what shell you’re in 

echo SSHELL 

Temporarily change to Bourne Shell 

Temporarily change to Korn Shell 

Temporarily change to C Shell (see Appendix) 
Permanently change to another shell 

sh 

ksh 

csh 

chsh username shell-path-name 

(then log out and log in again) 

Set command-line editor 

Edit your command line (once editor is set) 

set -o editor-name 

Press fisc); use vi commands to 
move cursor and enter text 

Recall a previous command line 

In vi mode, press (esc); press k 
(backwards) or j (forward) to 
move through command history 


file 

Execute a previous command line 

Press f Return | when desired 
command line is displayed 

Set a variable value 

VARIABLE-NAME= 

variable-value 

Enter a subshell 

Display PATH setting 

Set terminal parameters_ _ __ 

sh 

echo $PATH 

tset options term-type 
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Customizing Login Scripts 


The examples in this chapter show HP-UX default login scripts and local 
ogm scripts that customize your shell environment. Login script examples are 
provided for the Bourne Shell and the Korn Shell. 

This chapter covers the following topics: 

■ ™;xtr om,zation used in iogin * Tipts and h ° w *° use ,he ™p i « 

■ The default system login script for the Bourne and Korn Shells— 
/etc/profile. 

■ The default local login script for the Bourne and Korn Shells— 

/etc/d.profile. 

■ An example Bourne Shell .profile script. 

■ An example Korn Shell .profile script. 

‘ focTsr.Sef 1 ’ 611 $EW ( kShrC) m — d *» defining 
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Overview of Login Script Examples 

By modifying your login scripts, you can customize your shell environment 
to meet your needs. This chapter describes default system login scripts 
that contain examples of setting the time zone variable and checking f 
mail, news, and message of the day. Most types of customization are 
included in at least one script. For example, all shells let you permit or 
deny messages to your terminal, but only the example Korn She 
.profile script illustrates the mesg command. 


The scripts in this chapter are presented in two sets. In each set the s P 
commands are explained to help you understand what each script does. The 
first set presents scripts containing copies of the default scripts provided with 
HP-UX. The default login scripts are described in the sections tha egin w 
“The Default ” The second set presents scripts containing examples tor 
customizing your local login scripts. The local, customized login scripts are 
described in the sections that begin with “An Example.... 


Ways to Customize Login Scripts 

The following types of customization are commonly used in login scripts: 


■ Setting terminal characteristics. 

■ Setting search path and other global environment variables. 


Setting local shell variables. 

Setting default file permissions with umask. 

Setting up a logout script with trap (Bourne, Korn, and Key Shells only). 
Setting command aliases (Korn, Key, and C Shells only), 
i Setting history variables (Korn, Key, and C Shells only), 
i Displaying system status information and friendly messages, 
i Checking for the existence of mail. 

i Permitting or denying messages to your terminal with mesg. 


■ Setting the time zone variable. 

■ Checking for news and the message of the day. 
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Executing the System Login Script 

If you use the Bourne Shell or Korn Shell, /etc/profile is your system 
command V ' eW ‘ he ° f y °“ r Sy5tem login ^‘P 4 . use ‘1* more 

locXin Xl execute. 610 '° gln ^ *“ “ S the 

vonrl kn ?T What the SyStem l0gin SCript does ’ y° u can avoid duplication in 
y ur local login script. For example, the default system login script checks for 

mail, so your local login script does not need to check for mail too However if 
the system login script sets a different value for PATH than thJ i ’ j 

then change PATH in your local login scrip" ^ y0 “ need ’ 

Executing the Local Login Script 

After the system login script executes, the local login scripts execute as follows* 

■ The Bourne Shell uses one local login script-the .profile script All 

customization for this shell is done within the single login script inch din. 
both global environment variables and local shell variables. ’ § 

■ The Korn Shell uses two local login scripts. The .profile script 

$H0M U E/ S k a tl ll Sy T m l0gin SCript K the ENV variable has b ^n set to 
$HOME/.kshrc, the .kshrc script executes after the .profile script and 
each time you create a subshell. me script and 

1 otfer ^^e^Thf^appiron’lyTThe 

zizzazsr ,ocal “ - ° z ~ 
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# set the timezone 


# change this for local time. 


# if term is not set, 

# default the terminal type 


The Default System Login Script 
for the Bourne and Korn Shells: /etc/profile 

I Ur— P— — (/bin/ sh initialization) 

\r kept to the bar : 

PATH=/bin:/usr/bin:/usr/contrib/bin:/usr/local/bin #default path. 
if [ -r /etc/src.sh ] 
then 

. /etc/src.sh 
unset SYSTEM_NAME 
else 

TZ=MST7MDT 
export TZ 
fi 

if [ "$TERM" = "" 1 
then # 

TERM=hp 
fi 

export PATH TERM 

# set erase to ~H 
stty erase ~H 

# Set up shell environment: 
trap "echo logout" 0 

# This is to meet legal requirements... 
cat /etc/copyright 

if [ -f /etc/motd ] 

then „ _ 

cat /etc/motd * message of the day. 

i 

f i 

if [ -f /bin/mail ] 
then 

it mail -e * noti ^ 11 mal1 ' 

then echo "You have mail." 
fi 
f i 

if [ -f /usr/bin/news ] 

then news -n * notif * if new neWS - 

Tf [ -r /tmp/changetape ] # might wish to delete ^this: 

then echo ”\007\nYou are the first to log in since backup, 
echo "Please change the backup tapeAn" 
rm -f /tmp/changetape 

# leave defaults in user environment. 

trap 1 2. o 
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Task 

Ignore signals 


Set PATH 


Set time zone and 
system messages 


Set TERM 

Export global 
variables 


Explanation 

The opening trap command prevents anyone from interrupting 
the execution of the login script because the following signals 
are ignored: hangup (1), interrupt (2), and quit (3). These 
signals are described in signal ( 5) in the HP-UX Reference. 

The default PATH tells your shell to search /bin, /usr/bin 
/usr/contrib/bin, and /usr/local/bin. Your current, 
directory is not included. 


/etc/rc runs a set_parms script the first time your system 
boots. It allows you to interactively enter your time zone and 
system i.d. information. That data is written to /etc/src sh 
which is-subsequently read to set the TZ variable. If this script 
isn t found then .profile sets the TZ variable, in this case, to 
Mountain Standard Time and exports it. 


If the TERM variable is not set, this script sets it to hp. 
This expression exports PATH, and TERM to subshells. 


Set erase 
Trap logout 

Display copyright 
file 

Display motd file 
Check for mail 


List news items 


Check for backup 
tape 

Reset signals 


This sets the erase character to [ctrlY Ch). 

This trap command sets a trap on exit. When the shell exits 
the command “echo logout” is executed. 


The cat command displays the contents of /etc/copyright, 
ihis file contains copyright messages required by law. 


If the /etc/motd (“Message of the Day”) file exists as 
hie, the cat command displays its contents. 


a regular 


the file /bin/mail exists, the mail -e command checks your 
mailbox. If you have mail, the message “You have mail” is 
displayed. 


If the file /usr/bin/news exists, the news -n command is 
executed. This option displays the list of news files in 
/usr/news, rather than displaying the contents of the files. 

If the file /tmp/changetape exists and is readable, then the 
message, “Please change the backup tape” is displayed. 
Check your site’s backup procedures before changing the tape. 


ine nnai trap command resets the signals for hangup fl) 
interrupt (2), and quit (3). After the login script finishes 
executing, you are able to use hangup, interrupt, and quit again. 
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The Default Local Login Script 
for the Bourne and Korn Shell: /etc/d.profile 

The Bourne Shell and Korn Shell use a local login script named profile 
located in the home directory. Your system administrator or system installer 
gives you a default local login script based on the file /etc/d. prof 1 . y 

copy and edit the default login script yourself, make sure your copy is rena 
$H0ME/.profile, so that the system can recognize it. 

The default local login script resets the value of PATH, sets terminal 
characteristics, sets up the shell environment, and sets shell variables. 


# @(#) $Revision: 64.3 $ 

# Default user .profile file (/bin/sh initialization). 


# Set up the terminal: 

eval ‘ tset -s -Q -m ’:?hp’ 

stty erase kill "~U" intr -*C- eof 

stty hupcl ixon ixoff 

tabs 


"~D" 


# Set up the search paths: 

PATH=/bin:/usr/bin:/usr/contrib/bin:/usr/local/bm.. 

# Set up the shell environment: 

set -u 

trap "echo ’logout*" 0 

# Set up the shell variables. 

EDIT0R=vi 
export EDITOR 
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Task 

Set terminal 
characteristics 


Set PATH 


Set shell 
environment 


Set shell 
variables 


Explanation 

lo5in t8 B e lrT d S T 6rateS the TERM = (hp) P rom Pt during 
• S ‘ ,' ^ ° n the value y° u enter, the TERM environment variable 

(~^» a t!? 6 termmal ’ s characteristics are defined. If you press 
[Return ) , TERM IS Set to hp. ^ P 

The stty command sets key definitions, options for modem 
onnections, and tabs. Refer to stty( 1) for more information. 

The value of PATH is explicitly changed, meaning the entire value of 

L end of PATH 6 If^ ^ the ***£% 

cannnM f i U y ° U pt t0 execute a command that HP-UX 

thTh ii°* a T g , ^ ° f the ° ther paths > this v alue of PATH causes 
he shell to search for the command in the current directory. 

The set -u command prevents the shell from attempting to execute 
mmand lines with undefined shell variables. This command is a 
safety feature because, by default, the shell substitutes a nufi value 
for variables that aren’t defined. For example, if a script use a 

^ * Va l u - WORK, the 

« ~ ^ She " 

command duplicates the one set in /etc/profile.) 

™ riableS EDII0B a ” d U " G « “ d - global 

editor is a Korn Shell variable that determines which line-editing 
command set the shell uses. To be certain that this variable is us^d 
select the preferred line editor, make sure that the VISUAL 
triable is not set or that it is set to the path of a compatible screen 
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An Example Bourne Shell .profile Script 

The Bourne Shell uses a login script named .profile iocated in your home 

directory From .profile, exported variables are passed to all subshells. 

Variables that are'not exported are used only by the login shell The following 
script sets terminal characteristics, global environment variables and local she 
variables used only by the login shell. The script also sets up a logout script 
and displays some system status information. 

# Set terminal characteristics: 
eval ‘ tset -s -Q _ m ’ :hp2623a’ 
tabs -T$TERM 

PATH=$HOME/mybin:/bin:/usr/bin:/usr/contrib/bm./usr/local/bin 


# Export global variables: 
export PATH 

# Set local shell variables: 

PS1=’$L0GNAME $ ’ 

CDPATH=.:••:$H0ME 

# Set up logout script: 

trap "echo logout; $HOME/.logout" 0 

# Display system status information, 
date 

echo Currently ‘who I wc -1‘ users logged in 
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Task 

Set terminal 
characteristics 


Set PATH 


Export global 
variables 

Set local shell 
variables 


Set up logout 
script 


Display 
system status 
information 


Explanation 

fwanHP SaT 1 SCtS , an i exports the TERM environment variable 
terminal’s character!™^ ° COmmand also initiallzcs y° ur 

with the _isets the ,abs to tw 

This example sets PATH explicitly to search $HOME/mybin /bin 
directon^ / US ^ /con ^ rib/b ^ n ’ /usr/local/bin, and the current 

end of 2>ATH C fi '^ ParateS each direct °ry- The period at the 
end ot $PATH specifies the current directory. 

The export command allows shell variables to be passed to all 
commands that you execute. In this script, PATH is exported. 

The Bourne Shell has several predefined shell variables. This script 
sets two: PSl and CDPATH. (The* variable* could also be export 
to become global variables.) 

PSl is the primary shell prompt. Its default value is “$ I„ this 

script, PSl is changed to your username, followed by a dollar sign 
and a space. 6 

CDPATH sets the search path for the cd command. A colon (•) 
separates each directory. As set here, the cd command searches for 
the named directory in the current directory (.), the parent 
directory (. .), and the home directory ($H0ME). 

The traDrn Shed does not check for a .logout script automatically. 
The trap command sets a trap on exit of the shell. In this example 

you log out h ° eS l0g ° Ut ” and executes a logout shell script when 

The date command displays the current date and time. The ‘who | 

wc pipeline counts the number of users logged in and displays 
the results in the echoed string. 
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An Example Korn Shell .profile Script 


The Korn Shell distinguishes between environment variables and she 
variables. Environment variables are used by your shell when logging in or 
creating subshells. Shell variables are local to your current shell and are not 
passed to subshells. Environment variables are defined in the .profile script, 
and shell variables are defined in a .kshrc script. 


The following script sets 
and local shell variables, 
ability to send messages 


terminal characteristics, global environment variables, 
with the login shell. The script also turns off the 
to the terminal. 


# Set terminal characteristics: 
eval ‘ tset -s -Q -m ’:3001’ 
stty susp ~Z 

# Set environment variables: 
PATH=$HOME/mybin:$PATH 
ENV=$H0ME/.kshrc 

PS1="‘hostname' !$ " 

CDPATH=.:.•:$H0ME 


# Export global variables: 
export PATH ENV PS1 

# Set local shell variables: 

MAILPATH=/usr/mai 1 /terry: /usr /mail/kirn'/,"Kim has mail 
MAILCHECK=300 

# Deny messages to the terminal 
mesg n 
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Task ™ , 

Explanation 

moving jobs into the background. 

variaTes 0nment ™ S , exam P ,e f ts p A™ by adding to the existing value of PATH 
variables which 1S specified by $PATH. The $HOME/niybin directory is added as 

dunhcft d,reCt0ry - Wlth this search P ath - command names that you 
plicate in your mybin directory will be used in place of the 
xiE-UX version of the command. 

The ENV environment variable sets $HOME/.kshrc as the 
run-command login script. 

?X ps 'r:r men i variable is the shen pr ° mpt - us defauit value 

command th^ ^ ’ T COntain8 the ° Utput from the hostname 
command, the command event number, and the dollar sign ($). 

CDPATH sets the search path for the cd command. A colon (• 1 
separates each directory. As set here, the cd command searches for 
the named directory in the current directory (.), the parent 
directory (. .), and the home directory ($H0ME). 

The export command allows shell variables to be passed to all 

this example^ at ^ eXeCUtC ' PATH ’ ENV ’ and PS1 are exported in 

and MAH^Hfpx ^ Seveml pre ' defined she11 variables. MAILPATH 
and MAILCHECK are set in this example. 

The MAILPATH environment variable sets a search path for mail. In 
example, the shell sends a message whenever mail arrives in 
/usr/mail/terry or /usr/mail/kim. For terry, the default 

r zj°:ziyT L ” is "• For kim ' the —“ k - 

The MAILCHECK variable determines the frequency that the shell 
checks for mail The default value is 600 seconds (10 minutes). In 
this example MAILCHECK is changed to 300 seconds. 

The mesg command with the n option forbids messages written to 
your terminal via the write command. 


Export global 
variables 

Set local shell 
variables 


Deny messages 
to terminal 
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If the Korn Shell is your login shell, you can set up a run-command login 
script tSs script (usually called .kshrc) defines local shell variables Before 
Treat „g a kshrc Script in your home directory, be sure that the env.ronmeut 
S ENV is defined and exported in your .prof He *r.pt Thrs variable 
normally contains $H0ME/ .kshrc. When this is done, the .kshrc script 
executes when you log in and each time you create a subshe . 

Because the Korn Shell uses the .profile script only for login shells, 
commands that apply to all shells must be in $ENV. The 

local shell variables, command aliases, file access permission for files you create, 
and command history variables. The script is short to help it execute quickly. 


# Set shell variables 
set -o trackall 

# Set user file creation mask: 
umask 022 

# Set command aliases 
alias rm=’rm -i 
alias rename =, mv 

# Set history variables: 
HISTFILE=$HOME/.history 
HISTSIZE=30 
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Task 

Set shell 
variables 


Set user file 
creation mask 

Set command 
aliases 


Set history 
variables 


Explanation 

The set command sets options on how the shell processes 
commands. 

The -o trackall option tells the Korn Shell to track all commands 
that you execute. When commands are tracked, the shell remembers 
where the command is located and finds the command more quickly 
the next time it is used. 1 ^ 

The umask command determines the level of security assigned to 

aid read fir 6 ' ^ th ‘ S . eXample ’ the value 022 lets you create, edit 
and read files in your directories; other users can only read your files. 

The alias command is used to abbreviate long command lines 

differently' COmmands, ° r Cause standard commands to perform 

The first alias enforces the use of the -i option with the rm 

n If 18 optian ] causes th e rm command to ask whether to 
delete each file specified m the command line. 

The second alias creates a new command, rename, using the mv 
command. This alias provides DOS users with a more familiar 
command name for moving files. 

,aria “ e Set ' the “ le na ™ *» store the command 

JinMW , v Vanable 18 n0t Set ’ the default file name is 

$HOME/.sh_history. 

The HISTSIZE variable sets the number of previously-executed 
commands accessible by the shell. The default value is 128 
command lines. 
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For More Information . 

For more information on shell variables, refer to sh{ 1), fcsM^.fceysMl), 
and csh(l) in the HP-UX Reference and the shell tutorials in th e Shells and 
Miscellaneous Tool, volume of HP-UX Concepts and Tutorials Toe more 
information on specific commands used in these example scripts, refer to the 
HP-UX Reference. 


Chapter Command Summary 


Table 10-1. (For script examples, see the previous sections) 


To Do This ... 

Type This ... 

Edit system login script (Root permission needed) 

Copy and edit default login script 

Make sure variables are used in subshells 

vi /etc/profile 

cp /etc/d.profile 
$HOME/.profile; vi 
$HOME/.profile 

Include in .profile: export 
VARNAME 
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Networking with HP-UX 


Your HP-UX system can use a variety of networking services to enable vn„ 

»alT rr ° f "' ra *° °* her com » ut “ ^nrs These se^ices ca/aL 

procefLes remotely”* 0 161110,6 °" ‘ he " etWOTk "* ™» commands and 

ARPA/Sw iS « hapter give f y0U taformation on using three of the 
AKPA/Berkeley Services to do the following tasks: 


■ Copying files to and from a remote computer: ftp. 

■ Copying files remotely: rep. 

■ Logging onto another computer on the network: rlogin. 
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Copying Files Using ftp 

The ftp file transfer program allows you to copyfiies between your local 
system and remote systems and among remote HP-UX, UNIX, a 
non-UNIX network hosts that support ARPA services. This service not 
only allows you to perform remote file copying , but also facilitates file 
management operations such as changing, listing, creating, and dele g 
directories on a remote system for which you have a valid login or accoun . 

Using ftp you can copy a local file to a remote file or vice versa. You can 
also append a local file to the end of a remote file. The file to which you are 
copying can have either the same or a different directory path and/or name as 
the one on the originating system. 

Preparing to Use ftp 

. Make sure that your /etc/hosts file contains entries for the remote hosts 
with which you will communicate. 

. Have the system administrators for the remote hosts arrange to give you a 
pZord L an account, or a login to someone else's account, so that you 

can log in on the remote hosts. 


Transferring Files with ftp 

! To invoke ftp and connect to a remote host in one step, type the following: 


2. 


ftp remote-hostname 

This connects you to the remote host, ftp then confirms the connection and 
prompts you for a remote login name: 

Name ( reinote-hostTicLTnc ) . 


If you intend to log in with the same remote login name as you local login 
name, just press ( Returnj . 


Enter the password associated with your 
confirm this action with a message and a 


remote login name and ftp will 
confirmation that you are logged 


in: 
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Password ( remote-hostname ): 
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Password required for remoteJogm.name 
User remote^login-name logged in. 

3 ' g ° ing uT fcr bimry <“ op P OK!d «° ' rea dable” text) files type 

bin at the prompt, before proceeding. ’ ^ 

■ Use get to transfer files from a remote host to your local directory. 

□ At the ftp> prompt, type: 
get remote-file 

Can be the name ° f a file in the remote working directory, 
thp Ca fif’ P ’ C °? f ieS the file to the Iocal worki ng directory and gives it 

rLZm t?hTh > V 6 fiIe iS , in an0ther direct ° ry ° n the -moteta 

cooieftlfe fi p t fi , ° r r tlVe Path f ° r that file - In that case, ftp 

f f t0afile name Wlth the same Path on your local system 

If there is no matching path, ftp gives you a message, “No such file 

or irectory . If the destination file already exists, ftp overwrites its 
contents with the contents of the remote file. 

HdThp7 yiI Ih SaCCessfuIly ’ ft P S ives you messages confirming the copy 
and the length of time it required. py 

i Use put to transfer files from your local directory to a remote host. 

□ At the ftp> prompt, type: 

put local-file remote-file 

' fe^Z7^y Lfile “ C ° Pied *° ^ rem0te fl ‘ e " ame ta ‘ he SpecMed 

□ local file c<m be the name of the local file in your current local 

ZtZuT*' ftp wi " copy the flIe int0 a file of the ““ 

□ remote-file can be an absolute or relative path to a file name on 
the remote host. If not specified otherwise, it will be in the current 
working directory on the remote host. 
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Note 


If you have an ftp connection to a remote system, you cannot 
put or get a file back onto the same system. If you attempt 
this inadvertently, ftp gives you a message, “No such file or 
directory.” 


General File-Manipulation Commands for ftp: 

Some of the set of ftp file-manipulation commands, such «cJ, 

and rmdir function in the same way as the corresponding HP-UX commands. 

Others, such as append, delete, and led have functions which are unique 


Table 11-1. File-Manipulation Commands for ftp 


To Do This ... 

Type This ... 

Display the name of the current remote working 
directory 

pwd 

Display the name of the current local working 
directory 

!pwd 

Invoke a shell on the local host 

! 

Copy a local file onto the end of a remote file 

append 

Change -the working directory on the remote host 
to remote-directory 

cd remote-directory 

Change the working directory on the local host to 
locaL directory 

led local-directory 

List the contents of the current remote directory 

Is 

Create a remote directory 

mkdir remote-directory 

Delete a remote directory 

rmdir remote-directory 
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l“„“r ati0n ° n “ y ° f ‘ he f tP j “ St ** (- * 

Exiting ftp 

To close the connection with the remote host and exit ftp, type: 
bye 


) at 
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Copying Files Remotely Using rep 


You can copy files between HP-UX or other UNIX hosts on the network 
using rep. Also, using appropriate options, you can copy directories 
between systems using rep, if the configuration files that the service uses 

are set up properly. 


Preparing to Use rep 

Using rep allows you to copy files and directories to and from a remote host 

and to copy among remote systems as well. To use rep, you 11 need the 

following prerequisites: 

■ An account (login) on the remote host. 

■ A .rhosts file in the remote host home directory containing the names of 
your local host system and your local login name. 

■ A rhosts file on your local system, as well. This contains the names of all 
the systems you will copy from. It will ensure that you will be able to use 
rep when you use rlogin on the remote system. 

■ A /etc/host file on your local system which lists hosts with which you can 
communicate using ARPA/Berkeley Services. For each host the file has a 
line containing information about the remote host in the following form. 


internet-address official-name alias 

You will find that the /etc/hosts file is useful for looking up names and 
addresses on the network. To facilitate such a lookup, use the grep tool 
described in Chapter 8 in this manual. 

For example, an entry in the .rhosts file on the remote system might be: 


hpabc leslie 

where hpabc is the name of your local system and leslie is your local login 
name. ____ 

N t It is important to protect your remote .rhosts file and home 

directory to prevent unauthorized users from gaining rep access 
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to your remote account. Only you should be able to write to 
the .rhosts file. 

■ Make sure it is owned by you. 

■ Use chmod to set the permission of .rhosts to 400 

( -r )• See Chapter 12 for details. 

■ Do the same to protect the rest of your remote home 
directory with at least 711 (-rwx-x-x) permission. 


Copying a Local File to a Remote Host 

To copy from your system to a remote system, use the following syntax: 

rep local-file remote-hostname: remote-file 

bh^rpl^’ ^ /0 t C w/^ iS f n0t in y ° Ur CUrrent director y> you will need to supply 

from /I P H jf uT yOUr CUrrent director y) or the absolute path 

( om /), n addition to the local file name. You will need to specify the 

waTit t abS ° ! lte) r h ^ the remote ~fi le on remote-hostname only if you 
want it to go into a directory other than the remote home directory. 

called"^ 16 ’ ^ ^ myfil6 fr ° m y ° Ur CUrrent director y to a remote system 

rep myfile xyz:/users/leslie/otherdir 

In this case "yflie wi" be copied as myfile into the remote subdirectory, 
otherdir^ If you had only supplied the remote host name, rep would have 
copie myfile into the remote home directory, also as myfile. 

l°stem"„a a mJ n x C ‘z de * ““ ‘ n ^ deSti " ati0n ' FM eXampl<! ’ » 

rep myfile xyz:/users/leslie/otherfile 
In tte case, you have copied myfile as otherfile, in the remote directory 
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Copying a File on a Remote Host to Your Local Directory 

Now, to reverse the process, here is how you would copy a file from a remote 
host into your local directory. Use the following syntax: 

rep remote-hostname-.remote-file local-file 

For example, to copy myfile from your account in a remote system xyz into 
your current directory: 

rep xyz:/users/leslie/myfile . 

The dot ( ) you’ll remember from Chapter 3, is shorthand for “current 
directory”. In this case, myfile will be copied as myfile from the remote 
directory into your current directory. You do not have to supply the 
destination filename if you don’t want to copy it to a new name. 

If you want to copy myfile into another directory in your home system, use a 
path name, absolute or relative, as shown: 

rep xyz: /users/leslie/myfile otherdir/ 

Or, if you want to copy the file to another file name in another directory: 

rep xyz: /users/leslie/myfile otherdir/otherfile 

Run the Is command to confirm what you have done. 

Copying a Local Directory and its Contents to a Remote System 

To copy a local directory with all its files and subdirectories to a remote host, 
use rep with the -r (recursive) option using the following syntax: 

rep -r local-dir remote-hostname: remote-dir 

As before, if local-file is not in your current directory, you will need to supply 
the relative path (to get from your current directory) or the absolute path 
(from /), in addition to the local file name. Also, the remote-file will require 

an absolute path (from /). 

For example, you may want to copy a directory of miscellaneous files called 
work to a remote computer host called abc. To copy the entire work directory 
to a directory which is already there called products, type the following: 

rep -r work abc:/users/leslie/products 
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You have created a directory named work, with all its contents, in 

abc:/users/leslie/products. 

Agam, this assumes that you are doing this while you are in the local directory 

path ,o C °,ha a ; n H S T' °', herWiSe ' y ° U WOUW ^ “ Native or 

path to that directory, along with its name, such as /users/leslie/work. 

Copying a Remote Directory and its Contents to a Local System 

Jo copy a remote directory with all its files and subdirectories to a local 
irectory, use rep with the -r (recursive) option in the following syntax: 

rep -r remote- hostname -.remote- dir locaLdir 

For example you may want to copy a remote directory called work to your 
urrent directory. To copy the entire work directory, type the following: 

rep -r abc:/users/leslie/work 

conW| 0t R ^ l gni , fie , S the CUrrent directory ’ where the work directory will be 
copied. Run the lsf command to confirm that this has been done. 
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Logging in on Another Computer Using rlogin 


If you have an account on a remote host, then you can use rlogin o og m 
on a remote host by supplying your remote login name and password. You 
can then work on that system just as you would on your home system. 


If the remote host is configured to allow it, you can also log in on a remote 
host automatically, without having to supply your login name and 
password. 


Logging in on a Remote Host 

■ At the shell prompt, use the form: 
rlogin remote-hostname 

The remote-hostname is the name of an appropriately configured remote 
system. As before, this system is named in your /etc/hosts file and in your 
.rhosts file. The remote host prompts you for your remote password. 

. Enter your remote password. The remote host logs you in with the login 
message and the remote host prompt. 

If for some reason you should make an error in entering your password the 
remote host will give you the error message, Login incorrect, and will promp 
you for your login, and your password. 

Login incorrect 
login: 

Getting the Same Working Environment on the Remote Host 

To get the remote host environment to behave in the same way as you are 
used to having your home environment work, you can set the .profile or 
login values the same by copying your local .profile or .login files to your 
home directory on the remote system. As with your home system, the values 
in your .profile or .login will take precedence over the values in the remote 
system’s /etc/profile or /etc/csh. login file. 
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Logging Out and Exiting the Remote Host 

Myptag 08 0l “ ° f ‘ he re “ 0te h08 ‘ jUSt “ y ° U W0UM from !«>">« system, 
exit 


Typing (ctrl 


L±J also logs you out on most system. 

to HJMIX f y0U T ‘°| gged ° Ut ° f the rem ° te hoSt - disconnected, and returned 
prompt SyS ‘ em ’ Which diSplays a messa e e and your local 


Connection closed 

$ 


Temporarily Returning to Your Local System 


to f«*ute a command on y° ur local command while you are in 
riogin, type the rlogm escape character (normally a ~) followed bv ' and the 
command (The ~ will be invisible until you type the ! after") After the 
command has executed, riogin returns you to the remote host. For example: 


~! pwd 

/users/leslie 
[Returning to remote] 


Press GS, or enter a command to redisplay the remote host prompt 


For More Information ... 

Refer to the HP books, Using Network Services and Using ARPA Services. 
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Chapter Command Summary 


Table 11-2. Commands 


To Do This ... 

Type This ... 

Invoke ftp and connect to remote—host 

Copy files from remote-host to current directory, 

ftp remote-host 

get remote-file 

in ftp 

Copy files from your local current directory to the 
current directory on remote-host in ftp 

put local-file 

List the contents of the current remote directory 
Exit ftp 

Also see Table 11-1 for File-Manipulation 

Is 

bye 

Commands on ftp 

Copy a file from your local-file to a file on a 
remote host, using rep 

Copy a file from a remote host to your local 
directory, using rep 

Copy a directory structure from your local system 
to a remote host 

Copy a directory structure from a remote system 
to your local system 

rep local-file 

remote-hostname:remote-Jile 
rep remote-hostname.remote-fide 

local-file 
rep -r local-dir 

remote-hostname:remote-dir 

rep -r 

remote-hostname:remote-dir 

local- dir 

Log in on a remote system 

Exit rlogin 

rlogin remote-hostname 

exit 
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Making Your System Secure 


-UX provides many security features to protect files from unauthorized 
access However, you need to follow good security practices to maintain 
ecurity on your system. The degree to which you need to enforce security 
measures depends on where you work, the security policy in your workplace 
and the type of information with which you work workplace, 
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■ Become familiar with the security policies of your workplace. 

■ Keep your terminal secure. 

. Choose a secure password, and protect your password after you've chosen it. 

• Be aware of who has permission to access your files and directories and be 
able to control such access. ’ a De 


Security requires ongoing attention, and it may be impossible 
to have a 100% secure system under all circumstances. 

erefore, this chapter gives you some guidelines for securing 
your system. However, even these cannot guarantee you a 
completely secure system. 
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Securing Your Terminal 


When you are working with sensitive material, take care to position your 
terminal so the screen is not visible to others. Never leave your terminal 
unattended. Log off (exit) when you leave your terminal, or, it you re 
using VUE or the X Window System, lock your screen. 


Guidelines for Securing Your Terminal 

When working with sensitive material, take these security precautions: 

. Position your terminal so the screen points away from open windows and 
doors. 


■ Never leave your terminal in a non-secure state: 

□ Exercise care when logging in. Make sure no unauthorized person is 
observing you while you’re entering your password. 


Log off if you will be away from your terminal for a time. 

Clear your display, even if you leave your terminal for a brief period. Type 
dear at the command line prompt. (Note that the clear command 
clears only the current screen; one can still scroll up and see previous 

screens.) 


Check the security policies in your workplace. You may be 

required to log off whenever you leave your terminal, even if 
only for a brief period. 
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Working in an Audited Environment 

HP- UX pro V1 des the capability to audit computer use, both on an individual 
and system-wide basis. Depending on how your system is configured, your 

actiZ “ by / n aUdit Pr0gram ' This subsystem monitors user 

actions at your terminal and records security-relevant information. 
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Choosing a Secure Password 

When you choose a password, you want to ensure that no one can guess 
what you chose. If someone knows your password, that person may log in 
and access your files. This section offers suggestions on how to select and 
protect your password. These guidelines are of particular significance if you 
work with sensitive material. 


Selecting a Secure Password 

When selecting a password in a secure environment, follow these guidelines: 

■ Choose a password that isn’t publicly associated with you (your personal or 
professional life, your hobbies, etc.). 

a Don’t use your name, your spouse’s name, your children’s names, or your 
pets’ names. 

□ Don’t use the name of your street or your car. 

□ Don’t use phone numbers or special dates (anniversaries, birthdays, etc.). 

□ Don’t use your address, social security number, or license plate numbers. 

■ Choose a password that isn’t listed in the dictionary (spelled either forwards 
or backwards). Password-cracking programs can use dictionary lists. 

What can you use as a password? Here are a few suggestions: 

■ Make up a nonsense word. 

■ Make up an acronym. 

■ Misspell a word intentionally. 

■ String together syllables from a favorite song or poem. 


12-4 Making Your System Secure 









Note 


HP-UX requires that your password be six to eight characters 
long. At least two of these characters must be letters 
(uppercase or lowercase); at least one character must be either 
a numeral (the digits 0 through 9) or a special character (such 
as or $). See Chapter 1 for some examples. 


Protecting Your Password 

When you have chosen your password, follow these guidelines to ensure that no 
one discovers it: 

■ Never write down your password. 

■ Don’t tell others your password. 

■ Don’t let others watch as you type your password. 

■ Don’t store your password in the function keys of a terminal. 

■ Change your password occasionally (for example, once every three or four 
months). Refer to “Setting Your Password” in Chapter 1, if you need 
information on how to change your password. 

■ If you use more than one computer, use a different password for each system. 
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Protecting Your Files and Directories 


Access permissions determine who can access your files and directories and 
the type of access allowed. You should always be aware of the permissions 
assigned. Check your files and directory permissions periodically to make 
sure appropriate permissions are assigned. If you find any unfamiliar files 
in your directories, report them to the system administrator or security 
officer. 


Always carefully consider the permissions you allow on your files and 
directories. Give others access to them only when you have good reason to do 
so (if you are working on a group project, for example, your group may need 
access to certain files or directories.) 

As you learned in Chapters 3 and 4, the basic access permissions assigned to 
files and directories distinguish between three classes of users: owner, group, 
and other. 

Each of the classes of users can access files or directories in any of three 
ways: read, write, and execute/search ( r, w, and x). You can list the access 
permissions of your files and directories by using the 11 command. 

For information on access control lists (ACLs), which allow finer control of 
access to files, see ac/(5) in HP-UX Reference and HP-UX System Security. 

Access to Sensitive Files 

Make sure that permissions assigned to sensitive files and directories are 
appropriate. Here are some general suggestions: 

■ Only you should be able to write to your home directory. 

■ Only you should be able to write to the files used to customize your home 
environment, for example, .login and .profile. (.profile is discussed in 
Chapter 10.) 

■ Only you (and the pseudo-group “mail,” assigned to the mailer) should be 
able to write to your mailfile /usr/mail /username. 
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For More Information ... 


For details on determining permissions, by using the 11 command, see the 
section in Chapter 2 “Finding Out Who Can Use Your Files” or the section 
in Chapter 3 “Displaying Directory Permissions: The 11 Command,” in this 
manual. 
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Changing Who Has Access to Files 


If you want to change the basic access permissions assigned to a file use the 
chmod (change mode) command to control who has read, write and execute 
permission to your files. 


You can change file permissions using the chmod command. The chmod 
command sets a file’s read, write, and execute permission for you, the file’s 
group, and other users. Before using this command, you should always 
carefully consider what file permissions you give to others. 

In general, give others access to your files only when you have good reason to 
do so (if you are working in a group project, for example, your group may need 
access to certain files). 

Using chmod to Set File Permissions Numerically 

To illustrate the chmod command, you can set the permissions for myf ile so 
that only you can read from and write to the file. A commonly-used syntax for 
chmod is as follows: 

chmod number file-name 

Number is a three-digit number specifying what permissions you want to assign 
to the file. Each of the three digits sequentially sets permissions for each of the 
three classes: the owner, the group to which the owner belongs, and all other 
users. The file-name is the name of the file you want to protect. 

Also, each of the three digits can be thought of as made up of a sum of one or 
more of the following, taken separately for each of the three digits: 

0 no permission (-) 

1 execute (x) permission only 

2 write (w) permission only 
4 read (r) permission only 

Then, by this scheme: 

■ 400 gives “read” (r-) permission for you, the user, only. 

■ 440 gives “read” (r—r-) permission for you and your group. 


12-8 Making Your System Secure 













■ 700 (4 + 2 + 1, 0, 0) gives “read, write, and execute” (rwx-) 

permission for you, but no permissions to anyone else. 

Using chmod to Set File Permissions Symbolically 

You can also specify permissions for chmod using the letters u, g, and o, as 
symbolic code for the owner (“user”), group, and others (the class). This 
“symbolic mode” is an easier scheme to remember than the numeric mode, 
since the symbols r, w, and x (the mode ) are used directly as arguments in the 
command. Setting up the chmod syntax is a little different, making use of the 
+, -, and = signs. The syntax is: 

chmod class 

For example, you can use the symbolic mode to create 644 (rw-r—r—) 
permissions by specifying the symbols rw, r, and r directly in the chmod 
command. “User” is represented by u, “group” by g, and “other” by o. To 
assign the permissions absolutely , use the = sign in the argument. Unspaced 
commas separate class-permissions: 

chmod u+rw, g+r, o+r file-name 

To create 600 (rw-) permissions and set “no permissions” for the classes 

g and o., use = with no symbol following: 

chmod u=rw,g=,o= file-name 

Permissions are added with the + sign. Again, separate each class-permission 
with a comma and no space: 

chmod u+rw,g+r,o+r file-name 

You can also subtract permissions from u, g, or o, using -, if you just want to 
restrict the level of permission from a previous “higher” level. For example, if 

you had set rwxrw-rw- and you wanted to change this to rwx- 

(g represents “group” and o represents “other”): 

chmod g-rw,o-rw file-name 

However, unless you began with no permissions you may find that using + or 
- has added to, or subtracted from, some previously existing permissions for 


mode t [ ... ] file-name 
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that file. Run the 11 command to check this. If in doubt, set the permissions 
absolutely by using =. 
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For example, suppose you want to protect myf ile so that neither you nor 
anyone else can modify it, but everyone can still read from it: 

$ chmod 444 myfile 

or 

$ chmod u=r,g=r,o=r myfile 

When permissions are being set the same, you can also combine the arguments 
as: 

$ chmod ugo=r myfile 

With only read permission on myfile, no one can write to it. Also, if you now 
try to remove myfile, the rm command asks you whether you really want to 
remove the file: 

$ rm myfile 

myfile: 444 mode? (y/n) n If you do not want to remove it, enter n. 

If you do want to remove it, enter y. 

Later, if you want to permit yourself and members of your group to read from 
and write to myfile, use chmod as follows: 

$ chmod 664 myfile 

or 

$ chmod ug=rw,o=r myfile 
The 11 command now should show: 

-rw-rw-r-- 1 leslie users 154 Nov 4 10:18 myfile 

For More Information ... 

This section covered some of the most common uses of the chmod command for 
protecting files. To learn more about chmod, refer to the following: 

■ The manual System Administration Tasks 

■ The chmod( 1) entry in the HP-UX Reference. 
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Table 12-1 summarizes the various chmod commands you can use to protect 
myfile. 


Table 12-1. Summary of Uses of chmod 


To Set Permissions so 

Type This ... 

that ... 

Numeric: 

Symbolic: 

Only you can read from 
myfile, and no one 
(including you) can write to 
it. Set permissions to 
-r 

$ chmod 400 myfile 

$ chmod u=r,g=,o= myfile 

Everyone can read from 
myfile, but no one can 
write to it. Set permissions 
to r —r—r—. 

$ chmod 444 myfile 

$ chmod ugo=r myfile 

Only you can write to 
myfile, but everyone can 
read it. Set permissions to 
-rw-r—r—. 

$ chmod 644 myfile 

$ chmod u=rw,go=r myfile 

Only you and members of 
your group can write to 
myfile, but everyone can 
read it. Set permissions to 
-rw-rw-r-- 

$ chmod 664 myfile 

$ chmod ug=rw,o=r myfile 

Everyone can read from or 
write to myfile. Set 
permissions to -rw-rw-rw-. 

$ chmod 666 myfile 

$ chmod ugo=rw myfile 

Only you can read from or 
write to myfile, but no one 
else can. Set permissions to 
rw 

$ chmod 600 myfile 

$ chmod u=rw,go= myfile 
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Changing Who Has Access to Directories 


In addition to changing permissions on files, the chmod command can also 
change permissions on directories. Using chmod, you can control who has 
access to your directories, and what kind of access they have. For example, 
you can protect a directory so that no one can list its files. Or you can 
control whether users can remove, rename, or alter files in a particular 
directory. 


Table 12-2 defines some of the more common uses of chmod with directories. 

All the examples in this table assume that the directory projects exists under 
your current working directory. 


Table 12-2. Setting Directory Protection for the projects Directory 


To Set Permissions to ... 

Type This ... 

Numeric: 

Symbolic: 

Allow other users to list and 
access the files in projects, 
but not to create or remove 
files from it. Set permissions 
to drwxr-xr-x. 

$ chmod 755 projects 

$ chmod u=rwx,go=rx 
projects 

Allow all users to list, create, 
remove, and access files in 
projects. Set permissions 
to drwxrwxrwx. 

$ chmod 777 projects 

$ chmod ugo=rwx projects 

Allow only yourself to list, 
create, remove, and access 
files in projects. Set 
permissions to drwx 

$ chmod 700 projects 

$ chmod u=rwx,go=- 
projects 
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Note 


When determining who should be allowed to use your 
directories, be aware that anyone who can write to a directory 
also can remove or rename a file in that directory —even if that 
person cannot write to the file. 
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Controlling Default Access Permissions 


In the preceding section you learned how to change the permissions on 
individual files and directories using the chmod command. You should also 
be aware of the default permissions assigned to all of your files and 
directories at the time you create them. You can list or change the default 
permission settings by using the umask command. 


Default file permissions are assigned by the system whenever you create a new 
file or directory, and these are governed by your umask setting. Unless set up 
otherwise by you or your system administrator, your default umask setting will 
be 0, which means that new files you create will have read/write permission 
for everyone (666 or -rw-rw-rw-) and new directories you create will have 
read/write/search permission for everyone (777 or drwxrwxrwx). 

You may want to change your umask setting to a non-zero value, to make the 
default access permissions to your newly-created files and directories more 
restrictive. You can do so using the umask command and either the numeric or, 
in the Korn Shell, symbolic arguments. For simplicity, the following shows you 
how to use umask with numeric arguments. 

The number given as a parameter to the umask command works in an opposite 
manner to the number given to the chmod command. The “mask” serves to 
remove permissions as opposed to granting them. That is, the digits in the 
umask number are “subtracted” from 666 for files and 777 for directories when 
you are creating their initial permissions. For example, suppose you enter: 

$umask 022 

Now when you create new files their default permissions will be 644 
(-rw-r—r—). When you create new directories their default permissions 
will be 755 (drwxr-xr-x). If the umask value were instead set to 077, your 

default file permissions would be 600 (-rw-) and your default directory 

permissions would be 700 (drwx-). 

To find out what umask you currently have, type: 

umask 


Making Your System Secure 


12-15 









Note 

If you are using the Korn Shell or Key Shell, you can also enter 
the umask permissions symbolically. In the case above, you can 
type: umask u=rwx, g=rx, o=rx, with results as shown above 
for files and directory permissions. Check which shell-type 
you have by typing echo $SHELL, from you login shell, before 
attempting this. 

Here are some 

examples of common settings for umask: 

umask 077 

Assigns permissions so that only you have read/write access 
for files (read/write/search for directories) you own. All others 
have no access permission to your files and directories. 

umask 022 

Assigns permissions so that only you have read/write access 
to files (read/write/search access to directories) you own. All 
others have read access only to your files (read/search access to 
your directories). 

umask 002 

Assigns permissions so that only you and members of your 
group have read/write access to files (read/write/search access 
to directories) you own. All others have read access only to 
your files (read/search access to your directories). 

Caution 

You should not set a umask value, such as 2xx or 7xx, which 
restricts your access permissions to your own files. A number of 
HP-UX utilities, such as vi, assume that you can always access 
newly-created files. Such files might include the temporary files 
which vi creates. These utilities may malfunction when used 
under such a restrictive umask setting. 


If you set umask at a shell prompt, it will apply to shells and subshells in the 
current login session only. It won’t apply to future login sessions. To apply 
a umask setting automatically at login, add the umask command to your 
.profile (Korn and Bourne Shell users) or .login file (C Shell users). 
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For More Information ... 


To get more information about the umask command refer to the umask(l) 
entry in the HP-UX Reference). v 


To learn more about the .profile and 
manual, and Shells: User’s Guide. 


■ login files see Chapter 10 in this 
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Chapter Command Summary 


Table 12-3. Commands 


To Do This ... 

Type This ... 

Display file permissions 

11 

Numerically change file or directory permissions 

chmod number name 

Symbolically add or subtract file or directory 

chmod class±permissions name 

permissions 

chmod class=permissions name 

Symbolically change (absolutely) file or directory 

permissions 

Find out permissions mask setting 

umask 

Numerically change permissions mask setting 

umask mask-number 
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Using the C Shell Environment 

Use this section for reference to the C Shell. 

■ The default system login script for the C Shell— /etc/csh. login. 

■ The default user login script for the C Shell— /etc/d. login. 

■ An example C Shell . login script. 

■ The default user run-command script for the C Shell—/etc/d.cshrc 

■ An example C Shell . cshrc script. 

■ Using command history in the C Shell 



“ C She “' remember that il has a system login script and two user 
■ The /etc/csh.login is your system login script. 

‘ Jre^suLh “ aft6r ^ IOgi " ^ you 

• The .login script executes after the .cshrc script, but only during login. 


A 
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The Default System Login Script for the C Shell: 

/etc/csh.login 


: prom. rn. <«- iniUali-Uon,. 

# This should be kept to the bare minimum every user needs. 


# default path for all users. . 

set path=(/bin /usr/bin /usr/contrib/bin /usr/local/bin) 

set prompt="[\!] V. " 

setenv TZ MST7MDT # change this for 


local time. 


if ( ! $?TERM ) then 

setenv TERM hp 

endif 


# if TERM is not set, 

# use the default 


# This is to meet legal requirements... 

cat /etc/copyright 

# Miscellaneous shell-only actions: 

cat /etc/motd 


# copyright message. 

# message of the day. 


if ( -f /bin/mail ) then 
mail -e 

if ( Sstatus == 0 ) echo 

endif 


# notify if mail. 
’’You have mail. " 


if ( -f /usr/bin/news ) then 
news -n 

endif 


# notify if new news. 


if ( -r /tmp/changetape ) then # might wish to delete this 

echo 

echo "You are the first to log in since backup: 
echo "Please change the backup tape.\n" 


rm -f /tmp/changetape 

endif 
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Explanation 


Login Script 
Task 

Set path 


Set prompt 


Set time 
zone (TZ) 

Set TERM 

Display 
copyright file 

Display 
motd file 

Check for 
mail 

List news 
items 

Check for 
backup tape 


The default path tells your shell to search /bin, /usr/bin 

n:Sr b/b1 ”’ a " d The current b <3irectory l S 

The set command sets path as a local shell variable The C Shell 

tte 

S b " izizz * he c sm 

nn m h pr j * where n is the command evenl 

' mmand event numbers are used with the C Shell’s 

command history feature. 

Jn h l TZ r iable iS set t0 Mountain Standard Time. If you are in 
^ /etC/CSh l ° gin “ d ^t 

If the TERM variable is not set, this script sets it to hp. 

The cat command displays the contents of /etc/copyright This 
file contains copyright messages required by law. 

ThisfS C °™ nd T iiSplayS the contents of /etc/motd, if it exists 
his file contains the message of 2he day. 

displaying the contents of the files. ’ he than 

“ e /tm P /chan getape exists and is readable, the message 
Please change the backup tape” is displayed. Check yom site’s 
backup procedures before changing the tape 
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The Default Local Login Script 
for the C Shell: /etc/d.login 

The C Shell uses a user login script named .login located m the 
directory. The default user login script is based on the file /et / . g 

The C Shell user login script is similar to the ^SM 
script. The default user login script resets the value of PATH, sets term 

characteristics, and sets shell variables. 


# @(#) $Revision: 64.2 $ 

# Default user .login file ( /bin/csh initialization ) 


# Set up the default search paths. 

set path=(/bin /usr/bin /usr/contrib/bin /usr/local/b 


# Set up the terminal type: 

eval ‘tset -s -Q -m ’:?hp’ 
stty erase "~H" kill "“U" intr "“C" 
hupcl ixon ixoff tostop 
tabs 


eof "*D" susp "*Z" 


# Set up shell environment: 
set noclobber 
set history=20 
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Default Script 
Task 

Set path 


Explanation 


Set terminal 
characteristics 


Set shell 
variables 


The value of PATH to explicitly changed, meaning the entire value of 

the eXm™?' The „" eW Va ' Ue th ' « 

y° u a ^empt to execute a command that HP-UX 
cannot locate along any of the other paths, this value of PATH causes 
the shell to search for the command in the current direct" ) 

l«n tS nl7T d g ? erateS thC TERM = (h P } P r °mpt during 

is set and the Ter TT" enter ’ ^ TERM envi ronment variable 

set and the terminal s characteristics are defined. If you press 

(RenmJ at the prompt, TERM is set to hp. P 

The stty command sets options for key definitions, modem 
connections, and tab settings. Refer to stty( 1) for more information. 

The local shell variables noclobber and history are set. 

The shell variable noclobber restricts output redirection so the 
contents of files cannot be destroyed accidentally. 

The sheH variable history creates your command histoiy buffer and 
sets its size. In this script, history is set to record the last 20 
commands executed. If this variable is not set, you have no 

commands ^ edit and reUSe Proviously-executed 


Some Differences in Using the C Shell 

/Otr/f C/d eT gin differS sHghtly in Syntax and Unction from the 
/etcVd.profUe script used by the Korn and Bourne Shells The more nh • 
differences include the following: 1 he more obviou 

■ The C Shell does not have the set -u command. 

" *T ^ aeed a lo S° ut tra P in the C Shell because the C Shell 

utomatic^lly echoes “logout” and executes a logout script (if it exists) 
when you exit your login shell. P 1 StS) 

" S ZT T0R neu & u le iS ^ SGt ’ but the noc l°bber and history variables 
(which are C Shell variables) are set. 
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An Example C Shell .login Script 

The .login script is run after the .cshrc script when you log in. 

Like the Korn Shell, the C Shell distinguishes between environment variables 
and shell variables. Environment variables, defined in the . login scrip , 
used by your login shell and are passed to subshells. 

To copy the default script into your home directory, type these commands: 


7. cd 

% cp /etc/d.login .login 

7 . 


Changes to your home directory. 
Copies the default script. 


You can now edit this file for your own needs. The foUmving smpt set 
terminal characteristics, the global environment variable PATH, and the 
shell variable prompt. The script also displays a login message. 

# Set up the terminal type: 

eval ‘tset -s -Q -m ’console:300h’ -m ’-1200:pc 

LfpaS/Mn /usr/bin /usr/local/lib /Mr/lib *K0ME/.,M»> 

# Set local shell variables: 
set prompt 3 "[\!] " 

1 - d: - f5 ' - hMe a nice day 
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Explanation 


Set PATH 


Example Script 
Task 

characteristics 

- ‘ ~ M “n via a 

^t!?h t fi C ; ,mn “ d f ° r ,0Ur ° Wn tepla “ Md 

1200 with the descriptions you need. For example, you might set 

than O 9600 n h TrJ^ %0 ° baUd) and the other to <9600 (less 
an 9600 baud). Then replace the 300h and pc with the terminal 

types you use. (Refer to tset( 1) for more information) 

The set command sets local environment variables PATH is a global 
variable and path is a local variable in the C Shell. The C Shet 
automatically sets PATH equal to path. M 

This example explicitly sets the entire value of path The dot ( ) 

ZSSSttST direCt0ry ' ‘ H0 " E/, ' M ” been added to 

The set prompt command redefines the default prompt (*/. ) to 
ow the event number being typed. This feature is useful with the 
command history mechanism. As set here with [\'] the promot 
will consist of an event number n. J ’ ne I pt 

mpl eCh ° T mm f dS Write messa S es onto the terminal screen This 
message echoes the user’s name and the message “have a nfee dav’’ 
he user s name is extracted from the /etc/passwd file The ‘ V 
command finds the entry that contains $L0GNAME The cut 
command extracts the fifth field which should be the user’s name. 


Set local shell 
variables 


Provide login 
messages 
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The Default Local Run Command Script 
for the C Shell: /etc/d.cshrc 

Tn the C Shell the user run-command script is .cshrc. (The rc in the file 
name refers to the term run command.) When you first log in, the C Shell 
eZti the clc command in your home directory before ,t execute your 
log" n script. Additionally, the .cshrc script runs each tune you create a 

subshell. 

The default version of this script is /etc/d. cshrc. This script sets a restricted 
version of path for your subshells, sets local shell variables, and defi 
command aliases. 

# Default user .cshrc file (/bin/csh initialization). 

# Usage- Copy this file to a user’s home directory and edi 

# customize it to taste. It is run by csh each time it starts p. 

# Set up default command search path: 

# (For security, this default is a minimal set.) 

set path=( /bin /usr/bin ) 


# Set up C shell environment: 
if ( $?prompt ) then 
set history=20 
set savehist=20 
set system = 1 hostname‘ 
set prompt = "Ssystem \!• 


# shell is interactive. 

# previous commands to remember. 

# number to save across sessions. 

# name of this system. 

# command prompt. 


# Sample alias: 
alias h 


history 


# More sample aliases, commented out by default: 


# alias 

d 

dirs 

# alias 

pd 

pushd 

# alias 

pd2 

pushd +2 

# alias 

po 

popd 

# alias 

m 

more 


endif 
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Task 
Set PATH 


Set shell 
variables 


Explanation 

A restricted path is defined that includes only /bin and /usr/bin 
' mCe C * hrc executes befor e login during the login process this 
$H0ME/ e io W> Path k ° Verridden b y the P a th defined in ’ 
pathls used 1 "' heHS ^ SPaWned ’ the reStricted of 

If the shell is interactive, then various shell variables are set. 

The shell variable history creates your command history buffer and 
sets its size. In this script, history is set to record the last 20 
mmands executed. If this variable is not set, your subshells have 
no command history and you cannot edit and reuse 
previously-executed commands. 

The shell variable savehist tells the shell to record the last 20 

startim^histo f $H ° ME/histor y file - This file is used as the 
starting history for the next session. 

fo«7 able SyS *“ iS * et ‘° * he Valuc outp “‘ b » the Xostna., 


Set command 
aliases 


The shell variable prompt is set to the value in the system variable 
followed by the command event number and a colon. 

If the shell is interactive, then command aliases are set. A command 

alias 8 of ^e^ ^ - - 

The /etc/d.cshrc script also contains example aliases that are 

pound^gn f#Tafth ef h Ult ' T ° theSe aliases ’ remove the 

LmeX'.’co^Ld 81n ”'" S ° f ‘ he n ” e ' Ch “*' ne * he “ 


To copy the default script into your 
% cd 

/o cp /etc/d. cshrc .cshrc 

% 


home directory, type these commands: 

Changes to your home directory. 
Copies the default script. 
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If the C Shell is your login shell, it will look for . cshrc script^a .leg* 
variables, command aliases, and command history variables. 


# Set local shell variables: 
set noclobber 

set ignoreeof 

set notify 

set autologout 60 

# Set command aliases 

alias h ’history \\* I more’ 

alias cd ’cd \!*; dirs’ 

# Set history variables: 
set history=40 

set savehist=40 
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Task 

Set local shell 
variables 


Explanation 




■ noclobber prevents the contents of 
accidentally. 


a file from being overwritten 


ignoreeof forces you to end your session with the exit or 
logout command. Using (cm>® is not a , lowed 


■ notify tells the shell to notify 
processes are complete. 


you immediately when 


background 


Set command 
aliases 


Set history 
variables 


■ autologout automatically logs you out if you do not use the 
system for the specified number of minutes 

bl T r^r h . T a COmma " d * bat pipcs * he bistory 

The aliases for history and cd both use \! * This combination f 
character tells the C Shell to substitute any argument tothe 

useT/ “ ‘ hat P T‘ “ *"“• F ” «™Plo “you type 

/users, /users is substituted into the alias where \ u is 

? “sz 1 lcts 

the history buffer in the C Shpll thl*,- u- * 0ME / history. To use 
3 ne U bhe11 ’ the history variable must be set. 

hiSt ° ry V f iaWe t0 40 tells the C Shell to record the 

the C ^7 m , th f hi8t0ry file - The save hist variable teUs 
the C Shell to save the last 40 commands and use them as the 
starting history for the next session 
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Setting Environment Variables on the Command Line 

In the C Shell, environment variables are assigned new values with the setenv 
command: 


setenv name value 

Where name is the variable name and mine is the value assigned to the 
v£tri2tblG 

For example, the following command sets the PATH variable to search the /bin, 
/usr/bin, and current directories: 

•/ setenv PATH /bin: /usr/bin: Including : as the last element makes 
" setenv r ^ current directory the last one 

— searched. 


In the 


C Shell, shell variables are assigned with the set command: 


set name=value 

The path variable may be set to the same value in the example above by using 
the set command: 

•/ set path=(/bin /usr/bin .) Including . as the last element makes 
P current directory the last one 

— searched. 


A-12 C Shell 








Using Command History in the C Shell 

To see an example of command history operations in the C Shell, enter the C 
Shell: 

$ /bin/csh 

7« _ The cursor changes to indicate the change in shells. 

Activate the command history to store 20 commands: 

7. set history=20 

7 . _ 

Now type in some commands: 

7. date 

Wed Mar 29 10:57:28 MST 1989 
7. pwd 

/users/terry 
7« hostname 
hpfcma 

7. _ 

Now type in this command: 

1 history 4 

21 date 

22 pwd 

23 hostname 

24 history 4 

7. _ 

Notice that the C Shell displays the last three commands (date, pwd, and 
hostname) and the history 4 command. You can increase the amount of the 
command history shown by increasing the number that follows history. For 
example, this will display the last 100 commands if there are 100 commands in 
the history: 

7. history 100 

If there are fewer than 100 commands in the history, the full contents of the 
history will be displayed. 
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Re-executing the Previous Command in the C Shell 

To re-execute the previous command, type ! !. 

7, pwd 

/users/terry 

7. ! ! 

pwd 

/users/terry 

7. _ 

Recalling and Re-executing Commands in the C Shell 

To recall and re-execute an earlier command, type ! followed by the number of 
the command. 

7. history 4 

25 history 

26 pwd 

27 pwd 

28 history 

7. ! 26 

pwd 

/users/terry 

7. _ 

You can also recall a command by typing ! followed by the initial characters of 
the command string. 

7. !ho 
hostname 
hpf cma 

7. _ 

Editing and Re-executing the Most Recent Command in the C Shell 

To recall, edit and re-execute the most recent command, use the * symbol 
to delimit the portion of the command to be changed, following it with the 
corrected text. 

7. 11 /dve I grep ’~d’ I more 
/dve not found. 


100 

4 
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% "ve~ev 



11 /dev | grep ’~d’ 

1 more 


drwxr-xr-x 2 root 

sys 

24 Apr 23 10:00 dsk 

drwxr-xr-x 2 root 

sys 

2048 Feb 3 10:02 pty 

drwxr-xr-x 2 root 

sys 

2048 Feb 3 10:02 ptym 

drwxr-xr-x 2 root 

% _ 

sys 

24 Feb 3 10:00 rdsk 

Editing and Re-executing 

an Earlier Command in the C Shell 


Recall, edit and re-execute an earlier command by using the : s modifier. 

In this example, the command wc -1 is substituted for more in the original 
command. 


% history 3 31 u /dve | grep ’“d’ | more 

31 11 /dev | grep ’~d’ | more 

32 pwd 

33 history 3 

% !31:s/more/wc -1/ 

11 /dev | grep ’~d’ | wc -1 
4 

% 
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Glossary 


absolute path name 

m £ X ,eading to “■ s,arti " g ^ 

access permissions 

See file access permissions. 

ACL 

Access control list 

ANSI 

American National Standards Institute 

append 

s;™* - “ - - ;r;t 

application 

—e ly , such as 

argument 

be h LS u 0 pon COmmand lin<> Wh ‘ Ch identifleS What (ffle ' directo * * ) * *° 

ARPA 

Advanced Research Projects Agency, which developed ARPANET in the 


Gloss 
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ASCII 


American Symbolic Code for Information Interchange. 

backup 

A copy of all or part of the file system. 

baC To P “back up the file system” refers to the process of copying the file system 
to a separate disk or to a tape. 

BASIC T n , 

Beginner’s All-purpose Symbolic Instruction Code. 


bit 


Binary digiT 


Gloss boot 


To start up your system, loading it into the computer memory. 

b °°Sonly memory which is incorporated into a terminal for the Purpose 
starting the operating system, testing the terminal, and producing a 
standard display. 


byte 


A fundamental character-code unit, usually consisting of 8 or 16 bits. 


C A standardized and highly-portable computer language; also the name of 
the NLS default language/environment (formerly n-computer). 

^ An dement ^ fof thg organization , control, or representation of text. 

Characters include graphic characters and control characters. 

CD-ROM 

Compact Disc Read-Only Memory. 

A P n r ewprocess created by a pre-existing process. The pre-existing process 
is the parent process of the new process. 
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child directory 

See subdirectory. 


cluster node 


A member of a group of workstations connected via a LAN One 
the cluster server, performs as a server to the cluster. 


computer, 


cluster server 

A computer which provides file access, login access, file transfer, printing 
and other services across a network to a defined cluster of systems (cluster 
nodes) connected via a LAN. 


command 

A set of instructions you enter into the system to cause it to perform a 


command interpreter 

A program which reads lines of text from standard input (typed at the 
keyboard or read from a file), and interprets them as requests to execute 
other programs. An HP-UX command interpreter is called a shell. 

command history 

T he sequence of commands which you have entered, which is stored in 
.sh_history, and is recalled, line by line, on the command line by pressing 
(JESCJ twice and using vi scrolling commands. 


command prompt 

A message displayed by the shell indicated that keyboard 
Also called command line prompt. 


input is needed. 


CRT 

The system display (formerly called a “cathode ray tube”). 

current directory 

See current working directory. 


current working directory 

The directory in which relative path name searches begin. It is also called 

the current directory or working directory. 


Gloss 
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default search path / * , utd tty 

The sequence of directory prefixes that sh(l), tvme(l), and other HP-UX 

commands apply in searching for a file known by a relative path name 
(that is, a path name not beginning with a slash (/)). It is defined by the 
environment variable PATH. 


directory 

A table of identifiers and references (such as file names) that refer 
to corresponding files and items of data. Used in a typical HP-UX 
organizational structure to provide an organizational and logical identity 
for a given group of files and directories. 


DOS 

Disk operating system. 


0S The set of defined shell variables (some of which are PATH, TERM, 

SHELL, EXINIT, HOME) that define the conditions under which your 
commands run. These conditions can include your terminal characteristics, 
home directory, and default search paths. 


environment variable . , 

A shell variable that determines your terminal’s behavior in general, 
including default search paths, type of prompt, type of editor, and terminal 

type. 

EOF 

End-of-file. 

file access permissions 

A set of permissions which every file in the directory hierarchy has. These 
permissions are used in determining whether a process can perform a 
requested operation on the file (such as opening a file for writing). Access 
permissions can be changed subsequently through the chmod( 1) command 
or the chmod(2) call. 


file 

A named storage location in which you can store text or other data.. Files 
are the basic means which HP-UX uses to organize information. 
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fileset 

Describes a logical, defined set of files on an update or installation tape 
file system 

The organization of files and directories on a hard disk. 

filter 

A command that reads data from the standard input, performs a 
transformation on the data, and writes it to the standard output. 

Hex 

Hexadecimal 

home directory 

This is the directory where the user starts after logging in. It is the 
directory name given by the value of the shell variable HOME. 

host name 

A string which uniquely identifies a machine in a network. There are 
generally different host names associated with different networks. 

HP-UX cluster 

A group of workstations connected via a LAN. One computer, the cluster 
server, performs as a server for the cluster nodes. 

invisible file name 

A file name in which the first character is a dot (.) and which is not 
displayed by Is or by 11 without added options, such as -a. 

kernel 

The part of the HP-UX operating system that is an executable piece of 
code responsible for managing the computer’s resources. 

keysh 

The command for invoking the Key Shell. 

Key Shell 

An HP-UX shell which, as an extension of the Korn Shell, uses hierarchical 
softkey menus and context-sensitive help to aid users in building command 
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kilobyte 

1024 bytes, abbreviated Kbyte. 

LAN 

Local Area Network. 

LP 

Line Printer. 

login script 

The shell script, run at each login, which sets the login environment tor 
your terminal. 

special character 

A character that has special meaning to the HP-UX shell, as well as to 
commands such as find(l), and grep. The set of metacharacters includes: 
Gloss * ? I ‘ and &• Also called “metacharacters . 

node name 

The unique identifying name given to a system in a cluster, such as 
xyzleslie. 

operating system 

The contents of /hp-ux, including the kernel, input-output control, system 
accounting, storage assignment, and other services. 

Also see kernel. 

option . 

The part of a command line that changes the behavior of a command in 

certain ways. An option is usually preceded by a - . 

owner 

The owner of a file is usually the creator of that file. However, the 
ownership of a file can be changed by the super-user or the current owner 
with the chown(l) command or the chown(2) system call. 

PAM 

Personal Application Manager. 
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parent directory 

A directory which contains other directories ea^n • • , . . 

subdirectory (or child directory). ’ WhlCh 1S then cal,ed a 


parent process 

A pre-existing process which has created a child 
password 


process. 


An encrypted sequence of characters used by HP-UX to identify 
authorized user and to permit authorized login on asystem* 


an 


path name 

A sequenee of directory names separated by slashes and ending with a file 


PID 


process 

An 


Process Identification. Also see process identifier. 

program running in machine memory. 

identifier 

zrzzzfzzzi to 5,1 processes * the 


process identifier 

A 

system 


program (n.) 

A unit of executable code, in binary or “source” form Most HP TJX 
commands and routines consist of programs. 

RAM 

Random-access memory. 

relative path name 

in re,a.ion 

remote host 

A system W hich is named in your /etc/hosts. To log in and perform 
or system node name,'such as ny^ IZZ'Z , 
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remote system, you will need to have a local rhosts file which contains 
the system node name of the remote system. 

ROM 

Read-only memory. 

r0 ° T d he“Sst level directory of the hierarchical file system from which all 

In HP-UX, the slash (/) character refers to the “root 

directory”. 


3IOSS 


SerV This refers to a computer that provides file access, login access, file 

tots"ting and other services across a network to a defined cluster of 

systems (cluster nodes). Same as cluster server. 

sgid , . . v 

Set-group identification (permission). 

Shel An HP-UX command interpreter (Bourne, Korn, Key or C). 

*' U Afflfthat contains commands that a shell can interpret and run. 

S ““he variables, such as PATH, TERM SHELL and HOME that 
defines your terminal characteristics, home directory, and default sea 
paths, among other things. 

standalone 

A computer which is not part of a cluster. 

8tan Sd“"nation of error and special messages from a program, intended to 
^ for diagnostic merges. The standard error output » often called 

stderr. 

“‘“Thetoutoe of input data for a program. The standard input file is often 
called stdin. 
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standard output 

The destination of output data from 
is often called stdout. 


a program. The standard output file 


subdirectory 

A directory which is located in, or anywhere on a path below, another 
irectory, which is then called its parent directory. Sometimes called child 


subshell 

A shell created by another shell to run a program. 

SUID 


Set-user identification (permission). 


superuser 

A user with “root permission”, usually a system operator or administrator. 

system administrator 

The person in a group who is assigned to look after the system installation 

maintenance, updating, and installing new software for a system or cluster ’ 
of systems. 


system operator 

Same as system administrator. 

trusted computer system 

A system that employs sufficient hardware and software integrity measures 
to allow its use for sensitive or classified information. 

TTY 

teletypewriter. 

UID 

User Identification. 


user 

Any person who interacts directly with a computer system. 


Gloss 


Glossary-9 





username 

The name which identifies your account to the login program 
mail systems and other software requiring secure entry. 

user ID 

An integer which identifies each system user. 

working directory 

See current working directory. 

write protect 

Using the protective device on your tape cartridge to prevent 
accidentally overwritten. 
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c 

change directory permissions numerically, 
12-12, 12-17 

change directory permissions 
symbolically, 12-12, 12-17 
change file permissions, 11-7, 12-17 
change Key Shell configuration , 4-14 
change password, 1-20 
change working directory with cd , 3-24 
change your password, 1-16 
change your shell, 9-4, 9-5 
choose your password, 1-16 
copy a directory remotely, 11-8, 11-9, 
11-12 

copy a file from a remote system, 11-8, 
11-12 

copy a file remotely, 11-3, 11-7, 11-12 

copy a file with cp, 2-9 

copy files from remote system, 11-2 

copy text in vi, 6-16 

create a file, 2-12 

create files with cat, 2-2 

D 

delete a file, 2-12 
delete text in vi, 6-13 
determine what shell you are in , 9-24 
determine your shell, 9-2 
display directory permissions with 11 , 
3-22 

display file permissions, 2-10, 2-12, 

12-11, 12-14, 12-17 


display PATH setting , 9-24 
display permissions for a directory 11, 
3-24 

display sorted file: sort, 8-6 
display working directory with pwd. 
3-24 

E 

edit command line, 9-8 
edit command line , 9-24 
edit login script, 10-14 
enter a sub-shell, 9-24 
enter commands, 1-20, 4-2, 4-7 
enter password, 1-10 
enter text with vi, 6-4, 6-12 
errors, fix in vi, 6-2, 6-14 

F 

find a filename in a directory: find, 8-9 
find command help on-line, 4-12 
find command help on-line:man, 4-14 
find out directory permissions, 3-20 
find out shell name, 1-20 
fix errors in vi, 6-2, 6-14 

G 

get a file from a remote system: get, 
11-12 

L 

list files, 2-3, 2-10, 2-12, 3-24 
list files with Is, 2-9 
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log in, 1-10, 1-20 

log in on a remote system: rlogin, 
11-10, 11-12 
log out, 1-18, 1-20 

M 

mail a message: elm, 7-1 
manipulate files remotely: ftp, 11-4, 
11-12 

move a file, 2-12 
move text in vi, 6-16 

N 

networking: return to your local system, 
11-11 

o 

order files by field, 8-7 
order files: sort, 5-10, 8-9 
order files sort, 5-4 

P 

permanently change shells, 9-24 
print a file, 2-12 
print a file in vi: lp, 6-38 
print a file: with lp, 2-7 
print a file with lp, 6-22 
process and edit text in vi, 6-2 

Q 

quit vi without saving , 6-38 

R 

recall previous commands, 9-10, 9-24 
redirect input from a file to a command: 

command < infile , 5-14 
remotely copy a file, 11-6 
remove a directory with rmdir, 3-24 
remove a file interactively with rm -i, 
4-14 

remove files, 2-8 


remove files with the rm command, 2-9 
rename a file, 2-8, 2-12 

s 

save mail to a file, 7-12 
search for files using find, 8-2 
search for text patterns: grep, 8-4, 8-5, 
8-9 

send a file to a remote system: put, 
11-12 

send mail, 7-6 
set a variable value, 9-24 
set file permissions, 12-8 
set line editor, 9-6, 9-8 
set login environment, 9-12 
set mailer environment: the .elm 
directory, 7-3 

set mailer environment: the elmrc file, 
7-3 

set password, 1-20 
set search path for commands, 9-18 
set selected permissions (ACLs), 12-6 
set system environment, 9-14 
set terminal characteristics: tset, 9-23, 
9-24 

set terminal type, 1-11 
set vi defaults: .exrc, 6-36 
set your password, 1-16 
show Key Shell choices, 4-14 
sort file contents: sort, 8-6 

T 

temporarily change shells, 9-24 
terminate cat: ( Ctrl HdI , 2-2 
transpose letters in vi (xp), 6-17 

V 

view a file, 2-12 

view a file with more command, 2-6, 
2-7 
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w 

write and quit vi, 6-38 
write standard error and standard output 
to file , 5-14 
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A 

absolute path names, 3-6 
access control lists, 12-6 
accessing directories, 3-20 
accessing files, 2-10 
ACL, 12-6 

alias command, 10-12, A-8, A-10 
alphabetizing using sort, 8-6 
appending text, 6-9 
appending to a file, 5-7 
arguments, command, 4-2 
auditing, 12-3 

autologout shell variable, A-10 

B 

backspace, 6-7 

backward scrolling, 6-26 

backward searches, 6-28 

/bin directory, 9-19 

/bin/ksh program, 9-2 

/bin/sh program, 9-2, 9-12 

Bourne Shell, 1-6, 1-9, 2-5, 9-2, 9-3, 

9- 12, 9-14, 9-16, 10-2, 10-4, 10-6, 

10 - 8 
(BreakJ 

reentering login username, 1-10 

c 

cal command, 1-15, 4-4 
caps key, 6-24 
carriage returns, 6-5 
cat 


creating files with, 2-2 
terminating input, 2-2 
cat command, 2-2, 10-4, A-2 
cd command, 9-13, A-9, A-10 
CDPATH environment variable, 10-8 
change directory (cd), 6-36 
changing access to files, 12-8 
changing who has access to directories 
12-12 

changing your mailbox, 7-13 
changing your password, 1-16 
chmod command, 12-8, 12-12, 12-17 
chsh command, 9-5 
clear command, 12-2 
colon commands, 6-20 
command alias, 10-13, A-9, A-ll 
command history, 9-10, 10-13, A-3, 
A-5, A-7, A-9, A-ll, A-13 
command interpreter, 1-6 
command line, 4-5, 5-12 
command line prompt, 1-12, 1-14 
command mode, 6-7 
commands 
arguments, 4-2 
concepts, 4-1 

entering with the Key Shell, 4-6 
enter with Key Shell, 4-7 
line-editing, 9-6 

modifying previous in the C Shell, 

A-14 

multiple, 4-5 
options, 4-2 
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recalling in the C Shell, A-14 
re-executing in the C Shell, A-14 
re-executing in the Korn Shell, 9-10 
running several on the same command 
line, 4-5 
syntax, 4-2 

Commands (by name) 

/, 6-28 

alias, 10-12, A-8, A-10 
cal, 1-15, 4-4 
cat, 2-2, 10-4, A-2 
cd, 9-13, A-9, A-10 
chmod, 12-12, 12-17 
chsh, 9-5 

cp, 2-8, 2-9, 3-14, 3-15, 3-19, A-9 
cut, A-6 

date, 1-15, 5-7, 10-8 
dirs, A-10 

echo, 9-2, 9-17, 9-20, 10-4, 10-8, A-2, 
A-6 

elm, 7-1, 7-17 

exit, 1-18, 9-4, 11-11, 11-12 
export, 10-4, 10-6, 10-8 
find, 8-2, 8-9 
ftp, 11-1, 11-2, 11-4, 11-12 
G, 6-24 

get, 11-3, 11-12 
grep, 8-4, 8-9, A-6 
history, A-10 
hostname, 7-8, 10-10 
11 , 2 - 10 , 3 - 20 , 3 - 22 , 12-6 
11 -d, 3-22 
lp, 2-7 

Is, 2-3, 2-5, 9-22 
Is ”3i, 2-5 
lsf, 3-10 
mail, 10-4, A-2 
man, 4-12 
mesg, 10-2, 10-10 
mkdir, 3-10 


more, 2-6, 5-6, 5-7, 5-8, 5-10, 5-13, 

A-10 

mv, 2-8, 3-14, 3-15, 3-19 
news, 10-4, A-2 
passwd, 1-16 
put, 11-3, 11-12 
pwd, 3-6 

rep, 11-1, 11-6, 11-7, 11-8, 11-9, 11-12 
rlogin, 11-1, 11-10, 11-12 
rm, 2-8, 2-9, 10-4, 10-12, A-2 
rmdir, 3-16 

set, 10-6, 10-12, A-4, A-6, A-8, A-10, 

A-12 

setenv, A-12 
sort, 5-10, 8-6, 8-9 
stty, 10-6, A-4 
tabs, 10-8 
tee, 5-13 

trap, 10-2, 10-4, 10-6, 10-8 
tset, 9-23, 10-6, 10-8, 10-10, A-4, 

A-6 

umask, 10-2, 10-12, 12-15, 12-17 
wc, 5-8, 5-12, 10-8 
who, 5-6, 5-8, 5-12, 10-8 
whoami, 1-14, 5-5 

command substitution, 10-9, 10-11 
control key, 6-26 
conventions, typographical, 1-4 
copying a file, 2-8 
copying a file remotely 
rep , 11-7 

copying a file with cp, 2-9 
copying text, 6-18 
copying to a different file, 6-20 
correcting errors in commands 
Key Shell, 9-6 
Korn Shell, 9-6 

correcting typing mistakes with ( Back spacej , 
1-14 

cp command, 2-8, 2-9, 3-14, 3-15, 3-19, 
A-9 
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creating directories with mkdir, 3-10 
C Shell, 1-9, 2-5, 10-2, A-2, A-4, A-6, 
A-8, A-10 

command history, A-13 
. cshrc script, A-8 
modifying recalled commands, A-14 
recalling commands, A-14 
re-executing commands, A-14 
•cshr c script, 10-2, A-10 
[a-RLK n, 1-18 
(CTRL K ip, 1-18 

current directory, 9-13, 10-4, 10-7, 10-9, 
A-3, A-5, A-7, A-ll 
current directory, security, 9-20 
current message, 7-4 
current working directory, 3-4 
cursor movement commands, 6-8, 6-24 
cut command, A-6 

D 

date command, 1-15, 5-7, 10-8 
default environment, 6-33 
default login script, 10-2 
copying, 10-14 
default options, 6-33 
default prompts, 9-3 
deleting a directory with rmdir, 3-16 
deleting a file with rm, 2-8, 2-9 
deleting mail messages, 7-10 
deleting text, 6-9, 6-13 
directories 
accessing, 3-20 

changing who has access to, 12-12 
changing with cd, 3-12 
current working, 3-4 
execute/search permission, 3-21 
finding out who has access to, 3-20 
hierarchy, 3-2 
home directory, 3-4 
listing files in, 3-2, 3-6, 3-8 
listing with lsf, 3-10 
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moving and copying files with mv and 
cp, 3-14, 3-15 
navigating in, 3-4 
organizing your files, 3-1 
path names, 3-6 
permissions, 3-21, 12-6 
protecting with chmod, 12-12 
read permission, 3-21 
removing with rmdir, 3-16 
root (/), 3-4 
search permission, 3-21 
security, 3-21, 12-6, 12-12 
using and organizing files in, 3-2 
wildcard characters in directory names 
3-18 

write permission, 3-21 
directory 
root (/), 3-2 

directory, sub-, 3-2, 3-10 
dirs command, A-10 

E 

echo command, 9-2, 9-17, 9-20, 10-4, 
10-8, A-2, A-6 
editing existing files, 6-7 
EDITOR environment variable, 10-6 
editor options, 6-4, 6-32, 6-34 
EDITOR variable, 9-7 
electronic mail, see also mail, 7-1 
elm command, see also mail, 7-1 
elm environment 
• elm directory, 7-3 
elmrc file, 7-3 

ENV environment variable, 10-2, 10-10 
10-12 

. environ, 2-5 
environment, 6-36 

environment, shell, 9-1, 9-12, 9-14 9-16 
10-2 

environment variables, 9-16 
assigning values, 9-16 
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CDPATH, 10-8 

definition, 9-13 

EDITOR, 10-6 

ENV, 10-2, 10-10, 10-12 

global, 10-2, 10-4, 10-7, 10-9, 10-11, 

A-7 

HOME, 9-13, 9-20, 10-9 
LANG, 10-6 

local, 10-2, 10-7, 10-9, 10-11, A-3, 

A-5, A-7, A-9, A-ll 
L0GNAME, 9-13, 10-8, A-6 
MAIL, 9-13 

PATH, 9-13, 10-2, 10-4, 10-6, 10-8, 

10-10, A-3, A-5, A-7, A-9 
PS1, 9-16, 10-8, 10-10 
referencing the value in C, A-12 
SHELL, 9-2, 9-13, 9-17 
TERM, 9-13, 9-22, 10-4, 10-6, 10-8, 

10-10, A-2, A-4, A-6 
TZ, 9-13, 10-4, A-2 
ENV variable, 9-14 
error messages 

File exists, 6-20 
Line too long, 6-5 
Pattern not found, 6-28 
errors, recovering from, 6-14, 6-23 
escape character, 6-29 
escape key, 6-7 

/etc/copyright file, 10-4, A-2 
/etc/csh.login script, 10-2, A-2 
/etc/d.cshrc script, A-8 
/etc directory, 9-19 
/etc/d.login script, A-4 
/etc/d.profile script, 10-6 
/etc/hosts, 11-2, 11-6 
/etc/motd file, 10-4, A-2 
/etc/passwd file, 9-5, 9-12, A-6 
/etc/profile script, 9-14, 10-2, 10-4 
execute permission for files, 2-10, 12-6 
execute/search permission for directories, 
3-21, 12-6 


exit command, 1-18, 9-4 
exit ftp 
bye, 11-12 

exiting rlogin, 11-12 
exiting vi, 6-10, 6-20, 6-23 
export command, 10-4, 10-6, 10-8 
exporting variables, 10-14 
. exrc file, 6-36 


file permissions 

numeric mode, 12-8 
symbolic mode, 12-8 
files 

accessing, 2-10 
changing access to, 12-8 
concepts, 2-1 

copying between directories, 2-8, 3-14, 
3-15 

copying with cp, 2-9 
creating with cat, 2-2 
invisible file names, 2-5 
listing, 2-3 

moving between directories, 3-14, 
3-15 

naming, 2-4 

organizing in directories, 3-1 
permissions, 2-10, 12-6, 12-8 
printing, 2-7 

protecting with chmod, 12-8 
removing with rm, 2-8, 2-9 
renaming with mv, 2-8 
security, 12-6 
viewing contents of, 2-6 
wildcard characters (?, *) in file 
names, 3-18 
file sorting 
sort, 8-7, 8-8 
find command, 8-2 
Finding HP-UX Information , 1-5 
finding text patterns, 6-28 
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forward scrolling, 6-26 
forward searches, 6-28 
ftp, 11-1, 11-2, 11-12 
file manipulation, 11-4 


G 

global environment variables, 10-2, 10-4, 
10-7, 10-9, 10-11, A-7 
graphical user interface 
VUE, 1-8 

grep command, A-6 

H 

help, on-line, 4-12, 4-14 
hierarchical file system, 3-1 
HISTFILE shell variable, 10-12 
history command, A-10 
history shell variable, A-4, A-8, A-10 
HISTSIZE shell variable, 10-12 
$H0ME/.cshrc script, 10-2, A-6, A-8, 
A-10 

home directory, 3-4 

home directory (see also HOME 

environment variable), 10-6, 10-8, 
10-10, 10-12, A-4, A-6, A-8, A-10 
HOME environment variable, 9-13, 9-20, 
10-9, A-12 

$H0ME/.history file, A-9, A-ll 
$H0ME/.kshrc script, 9-15, 10-2, 10-10, 
10-12 

$H0ME/. login script, 9-15, 10-2, A-4, 
A-6, A-8, A-10 
$H0ME/. logout script, 10-8 
$H0ME/.profile script, 9-15, 10-2, 

10-6, 10-8, 10-10, 10-12 
$H0ME/.rhosts, 11-6 
$H0ME/.sh_history file, 10-13 
hostname command, 7-8, 10-10 
HP-UX Quick Reference , 1-1, 1-6 
HP-UX Reference , 4-12 


I 

ignoreeof shell variable, A-10 
inserting text, 6-8 
invisible file names, 2-5 

J 

joining lines of text, 6-5 

K 

Key Shell, 1-6, 1-7, 1-9, 2-5, 4-6 
correcting errors in commands, 9-6 
enter commands, 4-7 
line editing, 9-6 
using display, 4-6 

Korn Shell, 1-6, 1-9, 2-5, 9-2, 9-3, 9-14, 

9- 16, 10-2, 10-4, 10-6, 10-10, 10-12 
command history, 9-10 
correcting errors in commands, 9-6 
line editing, 9-6 

re-executing commands, 9-10 
• kshrc script, 10-2, 10-10, 10-12 

L 

LANG environment variable, 10-6 
leaving vi, 6-10, 6-20 
letter-case (lower- and upper-case), 
6-12, 6-24 
line editing 

choosing a command set, 9-7 
Key Shell, 9-6 
Korn Shell, 9-6 
setting vi, 9-7 
line-editing commands, 9-6 
listing file permissions with 11, 2-10 
11 command, 2-10, 3-20, 3-22 
local environment variables, 10-2, 10-7, 

10- 9, 10-11, A-3, A-5, A-7, A-9, 
A-ll 

local login script, 9-14, 10-2, 10-6, 10-8, 
10-10, 10-12 
logging in, 1-10 
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logging in on a remote system, 11-12 
logging out, 1-18 

logging out of a remote system, 11-11, 
11-12 

.login, 2-5 

login program, 9-12, 9-16 
login prompt, 1-10 

.login script, 10-2, A-4, A-6, A-8, A-10 
login script, 9-13, 9-14, 10-2, 10-4, 10-6, 
10-8, 10-10, 10-12, A-2, A-4, A-6, 
A-8, A-10 
login shell, 9-5 

L0GNAME environment variable, 9-13, 
10-8, A-6 

logout script, 10-6, 10-8, A-5 
looking at a file’s contents with more, 
2-6 

lp, 2-7, 6-22 
Is, 2-5 
Is -a, 2-5 

Is command, 2-3, 9-22 
lsf command, 3-10 

M 

mail 

addresses, 7-9 
command summary, 7-17 
concepts, 7-1 
current message, 7-4 
> (current message pointer), 7-4 
deleting messages, 7-10 
help command, 7-17 
reading, 7-4 
saving to a file, 7-12 
sending to users on other systems, 
7-8 

sending to users on your system, 7-6 
mailbox, 7-13 

MAILCHECK shell variable, 10-10 
mail command, 10-4, A-2 
MAIL environment variable, 9-13 


MAILPATH shell variable, 10-10 
man command, 4-12 
manipulating files remotely 
ftp, 11-12 

man pages, accessing with the man 
command, 4-12 
mesg command, 10-2, 10-10 
mkdir command, 3-10 
modifying recalled commands 
C Shell, A-14 

more command, 2-6, 5-6, 5-7, 5-8, 5-10, 
5-13, A-10 

mv command, 2-8, 3-14, 3-15, 3-19 
myfile, creating, 2-2 

N 

naming files, 2-4 
network copying 
ftp, 11-2 

news command, 10-4, A-2 
noclobber shell variable, A-4, A-10 
nodename, 7-8 
notify shell variable, A-10 
number option, 6-32 

o 

on-line HP-UX Reference entries, 4-12 
options, command, 4-2 
options, editor, 6-4, 6-32, 6-36 
organizing files in directories, 3-1 
overwriting files, 6-20 

P 

PAM (Personal Applications Manager), 
1-6, 1-9, 1-12, 2-5 
parameter substitution, A-12 
passwd command, 1-16 
password, 1-2, 1-10 
if none, 1-11 
protecting, 12-4 

rules for choosing a new, 1-16, 12-4 
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security, 12-4 

setting or changing your, 1-16 
PATH environment variable, 9-13, 10-2, 
10-4, 10-6, 10-8, 10-10, A-3, A-5, 
A-7, A-9 
path names, 3-6 

path shell variable, A-2, A-4, A-6, A-8 
permissions, 2-10, 3-21, 12-6, 12-8 
directories, 3-20, 12-6 
files, 12-6 

listing file permissions with 11, 2-10 
setting default permissions with umask, 
12-15 

Personal Application Manager, 1-6 
pipe, 5-12 
pipeline, 5-12 

positioning the cursor, 6-24 
Posix Shell, 9-2, 9-3 
printing a file 
lp, 2-7, 6-22 
process 
definition, 5-2 

process identifier (PID), 5-2 
.profile, 2-5 

profile script, 9-14, 10-2, 10-6, 10-8, 
10-10, 10-12 
program, 5-2 

prompt, command line, 1-12, 1-14 
prompt shell variable, A-2, A-6, A-8 
protecting directories with chmod, 12-12 
protecting directories with umask, 12-15 
protecting files with chmod, 12-8 
protecting files with umask, 12-15 
protecting your files and directories, 

12-6 

protecting your password, 12-4 
PS1 environment variable and shell 
variable, 9-16, 10-8, 10-10 
“put” command p, 6-18 
pwd command, 3-6 


Q 

:q!, 6-10, 6-14, 6-23 
quitting vi, 6-10, 6-23 

R 

rep, 11-1, 11-6, 11-7, 11-8, 11-9, 11-12 
reading mail, 7-4 

read permission for directories, 3-21 
12-6 

read permission for files, 2-10, 12-6, 
12-8 

recalling commands 
C Shell, A-14 
redirection 

appending output, 5-7 
standard input, 5-8, 5-10, 5-12 
standard output, 5-6, 5-10, 5-12 
re-executing commands 
C Shell, A-14 
Korn Shell, 9-10 
referencing variables, 9-16 
relative path names, 3-8 
remotely copying a directory 
rep, 11-6, 11-8, 11-9, 11-12 
remotely copying a file 
rep, 11-6, 11-12 

removing a file with rm, 2-8, 2-9 
removing directories with rmdir, 3-16 
renaming a file with mv, 2-8 
replacing text, 6-20 
restricted shells, 9-2 
rhosts, 11-6, 11-10 
rlogin, 11-1, 11-10, 11-12 
rm command, 2-8, 2-9, 10-4, 10-12, A-2 
rmdir command, 3-16 
root directory (/), 3-2, 3-4 
run-command login script, 9-15 
run command login script, A-8, A-10 
running commands, 1-14 
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savehist shell variable, A-8, A-10 
saving mail to a file, 7-12 
saving text, 6-7, 6-20 
saving to a different file, 6-20 
scroll, 6-26 

scrolling commands, 6-27 
searching for files using find, 8-2 
searching for special characters, 6-29 
searching for text patterns, 6-28 
search permission for directories, 3-21 
securing your terminal, 12-2 
security 

directories, 3-20, 3-21, 12-6, 12-12 
files, 2-10, 12-6, 12-8 
keeping your terminal secure, 12-2 
password, 1-16, 12-4 
system, 3-20, 12-1 16 
security of your current directory, 9-20 
sending mail, 7-6, 7-8 
set command, 6-32, 10-6, 10-12, A-4, 
A-6, A-8, A-10, A-12 
setenv command, A-12 
setting editor options, 6-32 
setting variables, 9-16 
setting your password, 1-16 
shell, 1-9 

SHELL environment variable, 9-2, 9-13, 
9-17 

shell escape, 6-22 
shells 

changing your shell, 9-4 
default prompt, 9-2, 9-14 
default shell, 9-12 

differences, 9-2, 9-14, 9-16, 10-2, A-5 
environment, 9-1, 9-12, 9-14, 9-16, 
10-2 

features compared, 9-2 
file names, 9-2 
Shells: User’s Guide , 1-9 
shell variables, 9-16 


autologout, A-10 
HISTFILE, 10-12 
history, A-4, A-8, A-10 
HISTSIZE, 10-12 
HOME, A-12 
ignoreeof , A-10 
MAILCHECK, 10-10 
MAILPATH, 10-10 
noclobber, A-4, A-10 
notify, A-10 
path, A-2, A-4, A-6, A-8 
prompt, A-2, A-6, A-8 
PS1, 9-16, 10-8, 10-10 
savehist, A-8, A-10 
showmode option, 6-4, 6-32 
signal trapping, 10-4, 10-6, 10-8 
single-quoting arguments, 4-4 
single-user system, 1-6 
sort, 8-6, 8-7 
sort command, 5-10 
sorting files by fields, 8-7 
special characters, 6-29 
standard error (stderr), 5-3 
standard input (stdin), 5-3, 5-8, 5-10, 
5-12 

standard output (stdout), 5-3, 5-6, 

5-10, 5-12 

stty command, 10-6, A-4 
subshell, 9-15 
system administrator, 1-6 
system login script, 9-13, 9-14, 10-2, 
10-4, A-2 

system manager, 1-6 
system operator, 1-6 
system security, 1-16, 3-20, 12-1-16 

T 

tabs command, 10-8 
tee command, 5-13 
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TERM environment variable, 9-13, 9-22, 
10-4, 10-6, 10-8, 10-10, A-2, A-4, 
A-6 

TERM = (hp), 1-10, 1-11 
TERM = (hp) prompt, 9-14, 9-22, 10-7, 
A-5 

Terminal Session Manager, 1-6 
terminal settings, 1-11, 9-22 
terminal type (term-type), 1-11 
terminal-user windows, 1-7 
terminfo database, 9-22 
text-copying commands, 6-19 
text-moving commands, 6-17 
text patterns 
finding, 6-28 

trap command, 10-2, 10-4, 10-6, 10-8 
tset command, 9-23, 10-6, 10-8, 10-10, 
A-4, A-6 
TSM, 1-6 

information sources, 1-7 
Terminal Session Manager, 1-7 
typing commands, 1-14 
TZ environment variable, 9-13, 10-4, 
A-2 

u 

umask, 12-15, 12-17 
umask command, 10-2, 10-12 
undo commands, 6-14 
upper-case letters, 6-12, 6-24 
user login script, A-4, A-6, A-8, A-10 
user name, 9-5, 9-12, 9-14 
username, 1-2, 1-10, 5-5 
/usr/bin directory, 9-19 
/usr/contrib/bin directory, 9-19 
/usr/lib directory, 9-19 
/usr/lib/terminfo database, 9-22 
/usr/local/bin directory, 9-19 


V 

variables 
assigning, 9-16 
setting and referencing, 9-16 
vi 

appending text, 6-12 

caps key, 6-3 

changing text, 6-30 

command mode, 6-2, 6-4 

creating files, 6-6 

deleting text, 6-16 

ending an editing session, 6-20, 6-23 

entering, 6-6 

entering commands, 6-4 

entering text, 6-4, 6-6, 6-12, 6-30 

environment, 6-36 

error s, recovering from, 6-2 

(isc) , using, 6-2 

inserting text, 6-12 

letter case, 6-3 

modifying text, 6-30 

opening blank lines, 6-12 

put command, 6-16 

replace command, 6-30 

substitute command, 6-30 

text-entry commands, 6-12 

text-entry mode, 6-2 

text-input mode, 6-4, 6-6 

typing text, 6-12 

vi Editor Quick Reference , 1-1, 1-6 
viewing a file’s contents with more, 2-6 
VUE 

information sources, 1-8 
logging in with, 1-10, 1-11, 1-12 
VUE (Visual User Environment), 1-6, 
1-8 

W 

:w, 6-20 

wc command, 5-8, 5-12, 10-8 
whoami command, 1-14, 5-5 
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who command, 5-6, 5-8, 5-12, 10-8 
wildcard characters (?, *), 3-18 
windows 

Visual User Environment, 1-8 
windows for terminal users, 1-7 
: wq, 6-7, 6-10, 6-23, 6-36 
wrapmargin option, 6-5, 6-32 
write permission for directories, 3-21, 
12-6 


write permission for files, 2-10, 12-6, 
12-8 

writing standard input, 5-8, 5-10 
writing standard output, 5-6, 5-10 

Y 

u yank” command yy, 6-18 
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